DDS Reference: ICF Files


SUBDEV (Subdevice) keyword for ICF files

Use this file- or record-level keyword to allow your program to request a specific subdevice (for example, a printer) to which transmitted data should be directed.

The format of the keyword is:

SUBDEV(*DC1 | *DC2 | *DC3 | *DC4)

The SUBDEV keyword is ignored at run time when EOS, DETACH, RSPCONFIRM, or RQSWRT is in effect. These keywords must have option indicators when they apply to a record for which the SUBDEV keyword applies. If an EOS, DETACH, RSPCONFIRM, or RQSWRT keyword with no option indicator applies to a record for which SUBDEV applies, an error message is issued and the SUBDEV keyword is ignored at creation time.

You can specify only one parameter value for each SUBDEV keyword.

You can specify this keyword more than once in the file; however, you cannot specify the same parameter value at the file-level and again at the record-level. This is true even if you specify option indicators each time. For example, if you specify SUBDEV(*DC1) at the file-level, you cannot specify SUBDEV(*DC1) anywhere else in the file.

If you specify the SUBDEV keyword at both the file-level and the record level, and your program selects the one at the file-level, the record-level keyword(s) have no effect even if also selected.

You can specify the SUBDEV keyword a maximum of four times for each record format. If you specify the SUBDEV keyword more than once, you must specify option indicators each time, and you can specify each keyword value only once.

The OS/400 program sends a device selection character as follows. The meaning of the device selection character is set by the remote system or device.

Parameter Value
Character Sent

*DC1
Hex 11

*DC2
Hex 12

*DC3
Hex 13

*DC4
Hex 5D

You cannot specify SUBDEV with the TIMER keyword.

Option indicators are valid for this keyword.

Example:

The following example shows how to specify the SUBDEV keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A  01                                  SUBDEV(*DC1)
00020A  02                                  SUBDEV(*DC4)
     A          R RECORD
     A

If indicator 01 is on, the OS/400 program sends the component selection character hex 11 on an output operation (no matter how indicator 02 is set).

If indicator 02 is on and indicator 01 is off, the OS/400 program sends component selection character hex 5D.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]