Requesting allocation information
To request information about the current dynamic allocation environment, specify info at the beginning of the parameter string.
BPXWDYN currently supports the retrieval of the ddnames, data set names, and path names for current allocations; other allocation attributes are not supported.
BPXWDYN supports single data set allocation. You can use the keys that are listed in Table 1 to specify which allocation
requests information is to be returned for.
Keys that are used in allocation requests | Action |
---|---|
DA(data set name[(member name)]) | DSN(data set name[(member name)]) | Specifies the data set name of the allocated resource about which you are requesting information. The data set name can contain special characters if the data set name is enclosed in apostrophes. It can also contain system symbols. The maximum length of the data set name is 44 characters, excluding any enclosing apostrophes and compressing any double apostrophes within the data set name. This key is mutually exclusive with the ddname (FI, DD), path name (PATH), and relative entry (INRELNO) keys. |
FI(name) | DD(name) | Specifies the ddname of the allocated resource about which you are requesting information. name contains the ddname. This key is mutually exclusive with the data set name (DA, DSN), path name (PATH), and relative entry (INRELNO) keys. |
INRDKYL(variable) | Requests the encryption key label that the access methods use to encrypt or decrypt the data. After returning to your program, the REXX variable variable contains the requested key label. |
PATH(pathname) | Specifies the path name of the file for which you are requesting information. pathname contains the path name and can contain system symbols. This key is mutually exclusive with the data set name (DA, DSN), ddname (FI, DD), and relative entry (INRELNO) keys. |
The keys listed in Table 2
are unique to BPXWDYN.
Additional keys for dynamic retrieval | Action |
---|---|
DIAG (stem | fdnum | STDOUT) | Specifies that diagnostic information is to be displayed. The information includes a compile time stamp, the input string, key parsing information for subsequent keys, and the list of generated text units. Specify STDOUT to send output information to the standard REXX output stream. |
MSG (WTP | default.S99MSG.| stemname | fdnum) | Directs messages to your job log (WTP), a REXX stem, or a file identified by a file descriptor number. If this key is not specified, messages are returned in the S99MSG stem, if possible. If BPXWDYN was not called from a REXX environment, the messages will be lost. WTP should be specified to obtain messages. |
INRCNTL(variable) | Requests return of the JCL CNTL statement reference. |
INRDSNT(variable) | Requests return of the data set type. Upon return to the program, the REXX variable
variable contains one of the following values or is blank:
|
INRDACL(variable) | Requests return of the data class of the specified SMS-managed data set. Upon return to the program, the REXX variable variable contains the data class identifier or is blank. |
INRELNO(request number) | Specifies the relative request number of the allocation for which you are requesting information. request number contains the relative request number. This key is mutually exclusive with the data set name (DA, DSN), ddname (FI, DD), and path name (PATH) keys. |
INRTFDAT(variable) | Requests the return of the organization of a z/OS UNIX file. Upon return to
the program, the REXX variable variable contains one of the following
values or is blank:
|
INRKEYO(variable) | Requests return of the key offset of a new VSAM data set. |
INRLIKE(variable) | Requests return of the data set name on the LIKE parameter. |
INRMGCL(variable) | Requests return of the management class of the specified SMS-managed data set. Upon return to the program, the REXX variable variable contains the management class identifier or is blank. |
INRPCDS(variable) | Requests the return of the disposition of the z/OS UNIX file during abnormal step
termination. Upon return to the program, the REXX variable variable
contains one of the following values or is blank:
|
INRPMDE(variable) | Requests return of the open mode for the z/OS UNIX file. Upon return to the program, the REXX
variable variable contains a comma-separated list with any of the following
values or is blank:
|
INRPOPT(variable) | Requests return of the open options for the z/OS UNIX file. Upon return to the program, the
REXX variable variable contains a comma-separated list with any of the following
values or is blank:
|
INRPNDS(variable) | Requests return of the normal disposition for the z/OS UNIX file. Upon return to the program,
the REXX variable variable contains one of the following values or is
blank:
|
INRRECO(variable) | Requests return of the organization of records in the specified VSAM data set. Upon return to
the program, the REXX variable variable contains one of the following values:
|
INRREFD(variable) | Requests return of the DD name that is specified by the REFDD parameter of the DD statement. |
INRSECM(variable) | Requests return of the RACF® security data set profile. |
INRSEGM(variable) | Requests return of the number of logical, line-mode pages to be produced for a SYSOUT data set before the segment becomes eligible for immediate printing. |
INRSPIN(variable) | Requests return of the spin data set specification. |
INRTATT(variable) | Requests return of the dynamic allocation attribute specification. This value is returned as two hexadecimal digits in character form. |
INRTCDP(variable) | Requests return of the conditional disposition of the data set Upon return to the program,
the REXX variable variable contains one of the following values:
|
INRTLIM(variable) | Requests return of the number of resources that must be deallocated before making a new allocation. |
INRTDDN(variable) | Requests the ddname that is associated with the specified allocation. Upon return to the program, the REXX variable variable contains the requested ddname. If the data set you specify is a member of a concatenated group and is not the first member, there is no ddname associated with it. |
INRTLST(variable) | Requests an indication of whether the relative entry request number, ddname,
or data set name that you specify is the last relative entry. Upon return to the program, the REXX
variable variable contains one of the following values:
|
INRTMEM(variable) | Requests the PDS member name. |
INRTDSN(variable) | Requests the data set name of the specified allocation. Upon return to the program, the REXX variable variable contains the requested data set name. |
INRTNDP(variable) | Requests the normal disposition of the resource. Upon return to the program, the REXX
variable variable contains one of the following values or is blank:
|
INRTORG(variable) | Requests the data sets organization. One of the following strings is returned: blanks, TR, VSAM, TQ, TX, GS, PO, POU, MQ, CQ, CX, DA, DAU, PS, PSU, IS, ISU, or four hexadecimal digits as returned from SVC99. |
INRTPATH(variable) | Requests the path name for the z/OS® UNIX file associated with the specified allocation. Upon return to the program, the REXX variable variable contains the path name, if any, associated with the allocation. |
INRTSTA(variable) | Requests the data set status of the allocation. Upon return to the program, the REXX variable
variable contains one of the following values or is blank:
|
INRSTCL(variable) | Requests return of the storage class of the specified SMS-managed data set. Upon return to the program, the REXX variable variable contains the storage class identifier or is blank. |
INRTTYP(variable) | Requests the data set type. One of the following strings is returned: blanks, DUMMY, TERM, SYSIN, SYSOUT, or two hexadecimal digits as returned from SVC99. |
INRTVOL(variable) | Requests the return of the first volume serial number associated with the specified allocation. |