Disable Link (QOLDLINK) API

The Disable Link (QOLDLINK) API disables one or all links that are currently enabled in the job in which the application program is running. When a link is disabled, all system resources that the link is using are released, the input and output buffers and descriptors for that link are deleted, and input or output on that link is no longer possible.

In addition to an application program explicitly disabling a link by calling the QOLDLINK API, user-defined communications support will implicitly disable a link in the following cases:

• When the network device associated with an enabled link is varied off from the job in which it was enabled
  
  
• When a job ends in which one or more links were enabled
  
  
• When the application program that enabled the link ends abnormally
  
  
• When the Reclaim Resource (RCLRSC) command is used
  
  
• When an unmonitored escape message is received

For each link that is successfully disabled, either explicitly or implicitly, the disable-complete entry will be sent to the data queue or user queue specified on the call to the QOLELINK API when the link was enabled. See Disable-Complete Entry for the format of the disable-complete entry.

Authorities and Locks

None.

Required Parameter Group

Return code

OUTPUT; BINARY(4)

The recovery action to take. See Return and Reason Codes.

Reason code

OUTPUT; BINARY(4)

The error that occurred. See Return and Reason Codes.

Communications handle

INPUT; CHAR(10)

The name of the link to disable. The special value of *ALL (left-justified and padded on the right with spaces) may be used to disable all links currently enabled in the job that the application program is running in.

Vary option

INPUT; CHAR(1)

The vary option for the network device description associated with each link being disabled. The valid values are as follows:

X'00'	Do not vary off the network device description.
X'01'	Vary off the network device description.

Return and Reason Codes

Return and Reason Codes for the QOLDLINK API