The following function codes are supported by the IOAMEM module:
Table 330 Function Codes Supported by IOAMEM Module
Function Code |
Description |
---|---|
INIT |
Set up the handler (optional). |
DELMEM |
Delete an existing member. |
DIRECTOR |
Retrieve the directory entry for a given dataset. |
DIRALL |
Retrieve the directory entries for a given PDS or concatenation of PDSs. DIRALL and DIRECTOR differ only in that DIRALL supports concatenated datasets in a DDname. DIRECTOR returns a buffer entry length of 11 bytes, 8 bytes for the member name and 3 bytes for the TTR, whereas DIRALL returns a buffer entry length of 52 bytes, 8 bytes for the member name and 44 bytes for the DSName in which the requested member(s) exist. |
DIRFULL |
Retrieve the full directory to a buffer. |
ENDLIBDE |
Close the last input member processed. |
FINISH |
Close last member and deallocate the library. |
GETLINE |
Read a member line by line. |
GETMEM |
Get a whole member into a buffer. |
INITMEM |
Prepare a member for GETLINE request. |
MEMSTAT |
Retrieve ISPF statistics for a given member. |
PUTMEM |
Write a whole member to a library. |
ALLOC |
Allocates a dataset and returns the dataset values. |
DEALLOC |
Deallocate a specific DDNAME. |
RECALL |
Submit a request to DFHSM to RECALL a migrated dataset. |
To map the parameter list, use the IOAMEM macro with the following format:
[name] IOAMMEM DSECT=[ NO | YES ] |
To invoke the IOAMEM module, specify the IOAMEM macro with the following parameters:
IOAMEM Macro Parameters
[name] IOAMEM request, Request type
HANDLE=, Handler address
BUFFADR=, Buffer address
RECNUM=0, Number of records in buffer
FROMREC=0, Read from record number
MCTADDR=0, MCT address
DSNAME=, DSNAME
MEMBER=, Member name
USERID==CL8'IOAUSER',
User ID
BUFFRMT=V, Buffer format
ACTION=A, Action for PUTMEM
ISPFSTAT=Y, ISPF statistics for PUTMEM
BUFFLOC=A, Buffer location
ESTAE=Y, ESTAE request
RECALL=N, If HSM migrated, do nothing
DUMP=N, DUMP option when ESTAE is yes
IOAMEMA=, Location of IOAMEM address
MF=[ L | E | (E,label) ]
Table 331 Parameter Explanation
Parameter |
Description |
---|---|
Request |
See the IOAMEM Macro Parameters code above. |
HANDLE=addr |
Address or register (2) ‑ (12) used as input and output |
BUFFADR=addr |
Address or register (2) ‑ (12) used as input and output |
RECNUM=addr |
Address or register (2) ‑ (12) or number used as input and output |
FROMREC=addr |
Address or register (2) ‑ (12) |
MCTADDR=addr |
Address or register (2) ‑ (12) |
DSNAME=addr |
Address or register (2) ‑ (12) |
MEMBER=addr |
Address or register (2) ‑ (12) |
DDNAME=addr |
Address or register (2) ‑ (12) |
USERID=addr |
Address or register (2) ‑ (12) |
BUFFMT=value |
V or D or address for GETMEM and PUTMEM only |
ACTION=value |
A or R or address for PUTMEM only |
ISPFSTAT=value |
Y or N or address for PUTMEM only |
BUFFLOC=value |
A or B or address |
ESTAE=value |
Y or N or address |
RECALL=value |
Y or N or address |
DUMP=value |
Y or N or address |
IOAMEMA=addr |
Address or register (2) - (12) |
ENQ=value |
N (none), P (partial), F (full – including member name) |
Parent Topic |