Skip to main content

Devices

Device types.

Synopsis

[Devices]    Name=a^b^c^d^e^f^g^h

Description

Each entry provides eight up-arrow (^) values that define a device. The maximum length of all strings is 128 characters, except for the Description string, which can be up to 256 characters. From left to right:

  • PhysicalDevice—The physical name used to refer to the device. The PhysicalDevice value specifies the device argument for this device’s OPEN command. The name can contain up to 128 alphanumeric characters; it can contain space characters as well. For example, for a printer you could enter the following, where MYNAME is the computer name.

    |PRN|\\MYNAME\ISF-HP5SiMX7

    Or:

    |PRN|\\MYNAME\Canon PIXMA

  • Type—The type of device. Options: TRM=Terminal. SPL=Spooling device. MT=Magnetic Tape drive. BT=Cartridge tape drive. OTH=Any other device including printers and sequential files. The default depends on the device type.

  • SubType—Used to refine the definition of your device subtypes. Subtypes specify terminal charactistics. They are used to create the appropriate OPEN command for the device. There should be subtype information for every terminal type.

  • Prompt—1, 2, or NULL (a blank or empty field) to choose a prompt. Options: 1=Automatically uses this device if it is the current device. 2=Automatically uses this device with predefined Right Margin and Parameter settings. If this field is left blank, the user sees the device selection prompt with the default device defined.

  • OpenParameter—A colon-separated string that provides the parameters, timeout, and mnespace arguments for this device’s OPEN command. The syntax for the OpenParameter string is:

    (parameters):timeout:"mnespace"

    Inside the parentheses for parameters, individual items are colon-separated, as follows:

    param1:param2:param3

    Resulting in:

    (param1:param2:param3):timeout:"mnespace"

    timeout and mnespace are optional, but if they are provided, the correct number of colons must separate them from previous entries in the OpenParameter string.

    parameters must be contained within parentheses only if there is more than one parameter. If there are no parameters, or if there is only one parameter, the parentheses may be omitted from the string. Thus the following is a correct and complete OpenParameter string:

    :timeout:"mnespace"

    If provided, mnespace must be contained within double quotes, as shown.

    For details about the OPEN command and its arguments, including a large variety of syntax examples, see the Caché ObjectScript Reference.

  • AlternateDevice—The device ID of another device. The value entered for AlternateDevice must be a defined mnemonic such as the Name supplied for another device.

    Specifying an AlternateDevice value for the device allows users of the %IS utility to specify “A” to tell Caché to use the alternate device. %IS is a general device selection utility for character-based applications. For details about %IS see the section “Allowing Users to Specify a Device” in the “I/O Devices and Commands” chapter of the Caché I/O Device Guide. The topic of most interest is “%IS Mnemonics,” which describes the conventions for entering the “A” code for %IS.

  • Description—A text description of where the device is located. This field is for your own reference to help you identify what machine you are configuring.

  • Alias—An alternate device ID (number) for this device. All aliases must be unique. You can use this value as the device argument in an OPEN command.

Examples

In the [Devices] section, each entry Name=a^b^c^d^e^f^g^h^i appears all on one line:

[Devices]
0=0^TRM^C-Terminal^^^^Principal device^
2=2^SPL^PK-DEC^^^^Spool LA120^
47=47^MT^M/UX^^("auv":0:2048)^^Magnetic tape^
48=48^MT^M/UX^^("avl":0:2048)^^Magnetic tape^
57=57^BT^M/UX^^("auv":0:2048)^^Magnetic tape^
58=58^BT^M/UX^^("avl":0:2048)^^Magnetic tape^
SPOOL=2^SPL^PK-DEC^^^^Spool LA120^
TERM=0^TRM^C-Terminal^^^^Windows Console^
|PRN|=|PRN|^OTH^P-DEC^^"W"^^Windows Printer^
|TNT|=0^TRM^C-VT220^^^^Principal device^
|TRM|=0^TRM^C-Terminal^^^^Windows Console^
Copy code to clipboard
Range of Values

As described above. The maximum length of strings is 128 characters, except for Description, which can be 256 characters.

Management Portal

On the page System Administration > Configuration > Device Settings > Devices is a list of existing devices. Select Create New Device, Edit, or Delete to modify the list.