Previous Topic

Next Topic

Book Contents

Book Index

Function Codes

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

IOAMEM Assembler Macro