- ,SDEVN=sdevn
- ,SVOLSER=svolser
- ,SUCBPTR=sucbptr
- One of the following three input parameters is required:
- ,SDEVN=sdevn
- A parameter field containing the binary device number of the
source device you want to snap.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 2-byte
field.
- ,SVOLSER=svolser
- A parameter field containing the volser of the source device
you want to snap.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 6-character field.
- ,SUCBPTR=sucbptr
- A parameter field containing the UCB address for the source
device you want to snap.
To code: Specify
the RS-type address, or address in register (2)-(12), of a fullword
field.
- ,SEXTINFO=sextinfo
- A required input parameter field that is an array of eight byte
source extent pairs to snap. 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.
- ,SEXTNBR=sextnbr
- A required input parameter field that tells how many source
extent pairs have been supplied in SEXTINFO.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a halfword field.
- ,TDEVN=tdevn
- ,TVOLSER=tvolser
- ,TUCBPTR=tucbptr
- One of the following three input parameters is required:
- ,TDEVN=tdevn
- A parameter field containing the binary device number of the
target device you want to snap.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 2-character
field.
- ,TVOLSER=tvolser
- A parameter field containing the volser of the target device
you want to snap.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 6-character field.
- ,TUCBPTR=tucbptr
- A parameter field containing the UCB address for the target
device you want to snap.
To code: Specify
the RS-type address, or address in register (2)-(12), of a fullword
field.
- ,TEXTINFO=textinfo
- A required input parameter field that is an array of eight byte
target extent pairs to snap. 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.
- ,TEXTNBR=textnbr
- A required input parameter field that tells how many target
extent pairs have been supplied in TEXTINFO.
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.
- ,TRELOCATE=trelocate
- ,TRELOCATE=NO
- An optional input parameter field containing a keyword that
indicates whether to perform cylinder and track relocation of the
target extent's count field identifiers. The value is left-justified
and padded on the right with blanks. If the field contains binary
zeros, the program uses the default.
NO indicates
that relocation is not to take place.
YES indicates
that relocation is to take place. For example, if a source extent
is cylinder 03 track 05, and the corresponding target extent is cylinder
08 track 06, then when the track is copied the count field will be
changed on the target device to have a count value of cylinder 08
track 06.
The default is NO.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 3-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.