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.
Table 1. Keys used to specify for which allocation request information is to be returned
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.
Table 2. Additional keys used for dynamic information retrieval
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:
  • PDS
  • PIPE
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:
  • BINARY
  • RECORD
  • TEXT
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:
  • DELETE
  • KEEP
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:
  • SISUID
  • SISGID
  • SIRUSR
  • SIWUSR
  • SIXUSR
  • SIRGRP
  • SIWGRP
  • SIXGRP
  • SIROTH
  • SIWOTH
  • SIXOTH
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:
  • OCREAT
  • OEXCL
  • ONOCTTY
  • OTRUNC
  • OAPPEND
  • ONONBLOCK
  • ORDWR
  • ORDONLY
  • OWRONLY
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:
  • DELETE
  • KEEP
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:
LS
Linear space
RR
Relative record
ES
Entry-sequenced
KS
Key-sequenced
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:
  • CATALOG
  • DELETE
  • KEEP
  • PASS
  • UNCATALOG
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:
  • 0 (not the last relative entry)
  • 128 (the last relative entry)
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:
  • UNCATALOG
  • CATALOG
  • DELETE
  • KEEP
  • PASS
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:
  • OLD
  • MOD
  • NEW
  • SHR
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.