HLDCMNDEV (Hold Communications Device)
HLDCMNDEV Command syntax diagram
Purpose
The Hold Communications Device (HLDCMNDEV) command allows the operator to hold communication through the specified device description in two ways: controlled or immediate. The controlled option allows any program using the communications device to continue to do input/output operations, but no new uses of the device are started. The immediate option stops a communications device immediately, and a permanent input/output error is sent to the program. Communications are restarted with the Release Communications Device (RLSCMNDEV) command or by varying the device off and then on (Vary Configuration (VRYCFG) command).
Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
Required Parameters
- DEV
- Specifies the name of the device whose communications are held. Devices whose communications are held are:
- DEV Value
- Device
- 3180
- Display station
- 3277
- Display station
- 3278
- Display station
- 3279
- Display station
- 3287
- Printer (work station)
- 5219
- Printer (work station)
- 5224
- Printer (work station)
- 5225
- Printer (work station)
- 5251
- Display station
- 5252
- Display station
- 5256
- Printer (work station)
- 5291
- Display station
- 5292
- Display station
- PLU1
- Primary logical unit, type 1 (for SNA)
- BSC
- Binary synchronous device (Base and RJE)
- BSCT
- This iSeries 400 as a BSC multipoint tributary station
- APPC
- Logical unit in advanced program-to-program communications (APPC) network
Specify the name of the device (as specified in the device description) whose communications capability is suspended.
Optional Parameters
- OPTION
- Specifies the manner in which communications with this device is held.
*CNTRLD: The specified device is not capable of communications at the next OPEN or ACQUIRE operation.
*IMMED: The specified device is not capable of communications at the next READ, WRITE, OPEN, or ACQUIRE operation.
Example for HLDCMNDEV
HLDCMNDEV DEV(WSPR05)This command holds the communications capability of the device WSPR05 at the time of the next OPEN or ACQUIRE operation.
Error messages for HLDCMNDEV
*ESCAPE Messages
- CPF5920
- Device &1 varied off or in diagnostic mode.
- CPF5921
- Device &1 not a communications device.
- CPF5922
- Device &1 already held with option *IMMED.
- CPF5935
- Error occurred during command processing.
- CPF5984
- Not authorized to perform function.
- CPF9814
- Device &1 not found.
- CPF9825
- Not authorized to device &1.