Hold Communications Device (HLDCMNDEV)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Hold Communications Device (HLDCMNDEV) command allows the operator to hold communication through the specified device. Communications are restarted with the Release Communications Device (RLSCMNDEV) command or by varying the device off and then on with the 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.

Top

Parameters

Keyword Description Choices Notes
DEV Device Name Required, Positional 1
OPTION Option *CNTRLD, *IMMED Optional, Positional 2
Top

Device (DEV)

Specifies the name of the device whose communications are to be 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 &sys. system as a BSC multipoint tributary station
APPC
Logical unit in advanced program-to-program communications (APPC) network

This is a required parameter.

Top

Option (OPTION)

Specifies the manner in which communication is held with this device.

The possible values are:

*CNTRLD
The specified device is not capable of communications at the next OPEN or ACQUIRE operation. 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.
*IMMED
The specified device is not capable of communications at the next READ, WRITE, OPEN, or ACQUIRE operation. The immediate option stops a communications device immediately, and a permanent input/output error is sent to the program.
Top

Examples 

HLDCMNDEV   DEV(WSPR05)

This command holds the communications capability of the device WSPR05 at the time of the next OPEN or ACQUIRE operation.

Top

Error messages

*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.
Top