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 |