Subparameters for REQUEST=SRELEASE

REQUEST=SRELEASE
is used to release functional tracks on an RVA device.
,DEVN=devn
,VOLSER=volser
,UCBPTR=ucbptr
One of the following three input parameters is required:
,DEVN=devn
A parameter field containing the binary device number of a device whose functional tracks are to be released.

To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.

,VOLSER=volser
A parameter field containing the volser of a device whose functional tracks are to be released.

To code: Specify the RS-type address, or address in register (2)-(12), of a 6-character field.

,UCBPTR=ucbptr
A parameter field containing the UCB address of for a device whose functional tracks are to be released.

To code: Specify the RS-type address, or address in register (2)-(12), of a fullword field.

,EXTINFO=extinfo
A required input parameter field that is an array of eight byte extent pairs to release. The first 4-bytes of a pair gives the starting track address and the last 4-bytes gives the ending track address (for a single track the two addresses would be the same).

To code: Specify the RS-type address, or address in register (2)-(12), of a character field.

,EXTNBR=extnbr
A required input parameter field that tells how many extent pairs have been supplied in EXTINFO.

To code: Specify the RS-type address, or address in register (2)-(12), of a halfword field.

,RETINFO=retinfo
A required output parameter field that is used to return detailed information about the results of executing the request. Information about the results of scheduling the request are returned in the RETCODE and RSNCODE fields. Align the area on a word boundary. The first 4-bytes contain the return code and the second 4-bytes contain the reason code. The remainder of the information is dependent on the return and reason codes. See the coding example SDM API usability guide about how to coordinate the RETCODE, RSNCODE, and RETINFO fields.

To code: Specify the RS-type address, or address in register (2)-(12), of a 100-character field.

,ECB=ecb
,ECB=NO_ECB
An optional input parameter field that SDM will post for an asynchronous request. This field is ignored for synchronous requests. The default is NO_ECB.

To code: Specify the RS-type address, or address in register (2)-(12), of a fullword field.

,WAITTIME=waittime
,WAITTIME=0
An optional input parameter field containing how long in seconds SDM will wait for a request to complete. A value of zero says to not time the request. If the time expires before the request is complete a value of RQST_WAITTIME_EXPIRED (see ANTRQSTL) will be returned. If the request is a synchronous request the value will be placed in the RTNCODE field. If the request is an asynchronous request the value will be used as the ECB post code. The default is 0.

To code: Specify the RS-type address, or address in register (2)-(12), of a halfword field.