MVS/XA Data Management Macros

Table 1. MVS/XA Data Management Macros That CMS Simulates
Macro Description and Parameters/Options Supported
BLDL Builds a directory list for a partitioned data set.
Read syntax diagramSkip visual syntax diagram dcb_address , list_address
BSP Backs up a record on a tape or disk.
Read syntax diagramSkip visual syntax diagram dcb_address
BUILDRCD Causes a buffer pool and a record area to be constructed.
Read syntax diagramSkip visual syntax diagram area_address , number_of_buffers , buffer_length , record_area_address ,record_area_length
CHECK Verifies READ/WRITE completion.
Read syntax diagramSkip visual syntax diagram decb_address ,DSORG=ALL
CHKPT No-op.

NOP

CLOSE Completes and secures I/O processing on a DCB.
Read syntax diagramSkip visual syntax diagram ( dcb_address ,REREAD,LEAVE,REWIND ) ,TYPE=T
CNTRL No-op.

NOP

DCB (BDAM)1 Constructs a data control block for BDAM.
Read syntax diagramSkip visual syntax diagram DSORG = DA , MACRF = ( RKISCWAKICRKISC,WAKIC ) ,BLKSIZE=,DDNAME=,EXLST=,LIMCT=,OPTCD=RAEF,RECFM=UVBF,SYNAD=
DCB (BPAM)1 Constructs a data control block (BPAM).
Read syntax diagramSkip visual syntax diagram DSORG = PO , MACRF = RWR,W,BLKSIZE=,DDNAME=,EODAD=,EXLST=,LRECL=,RECFM=UVFA,SYNAD=
DCB (BSAM)1 Constructs a data control block (BSAM).
Read syntax diagramSkip visual syntax diagram DSORG = PS , MACRF = ( RCPWCPLRCP,WCP , ,BLKSIZE=,DDNAME=,EODAD=,EXLST=,KEYLEN=,LRECL=,RECFM=UVFDBS,SYNAD=,OPTCD=QJ,BUFOFF=(0-99)L
DCB (QSAM)1 Constructs a data control block (QSAM).
Read syntax diagramSkip visual syntax diagram DSORG = PS , MACRF = ( GPGMLD1,PMLD1 ) ,BLKSIZE=,DDNAME=,EODAD=,EXLST=,LRECL=,RECFM=UVFDBSBS,SYNAD=,BUFL=,BUFNO=,BUFCB=,OPTCD=QJ,BFTEK=SA,BUFOFF=(0-99)L
Notes:
  • 1 MACRF of D is supported for assembly only. Data mode is not supported for execution.
DCBD Generates a DSECT for a data control block.
Read syntax diagramSkip visual syntax diagramDSORG=(BSDAPOPSQS)
DEVTYPE Obtains device-type physical characteristics.
Read syntax diagramSkip visual syntax diagram ddloc_address , area_address ,DEVTAB
Note: The DEVTYPE interface will not return valid track or cylinder details that can be used for DASD space calculations. It is intended only to give access to default device characteristics. If detailed real DASD device characteristics are needed, see CP DIAGNOSE X'210' in the z/VM: CP Programming Services or the CMS 'DEVTYPE' utility program in the z/VM: General Information.
EXCP Executes a channel program for graphic access method (GAM).
Read syntax diagramSkip visual syntax diagram iob_address
FEOV Forces an EOV condition on a tape or DASD file.
Read syntax diagramSkip visual syntax diagramaddressreg,REWINDLEAVE
FIND Locates a member of a partitioned data set.
Read syntax diagramSkip visual syntax diagram dcb_address , name_address,Drelative_address_list,C
FREEBUF Returns a buffer to the DCB buffer pool.
Read syntax diagramSkip visual syntax diagram dcb_address , register
FREEDBUF Releases a simulated BDAM buffer.
Read syntax diagramSkip visual syntax diagram decb_address , D , dcb_address
FREEPOOL Releases the DCB buffer pool.
Read syntax diagramSkip visual syntax diagram dcb_address
GET Reads system-blocked data (QSAM).

GET is supported for Locate and Move modes only.

Read syntax diagramSkip visual syntax diagram dcb_address ,area_address
GETBUF Acquires DCB buffer storage.
Read syntax diagramSkip visual syntax diagram dcb_address , register
GETPOOL Constructs a buffer pool for a DCB.
Read syntax diagramSkip visual syntax diagram dcb_address , number_of_buffers,buffer_length(0)
NOTE Manages data set positioning.
Read syntax diagramSkip visual syntax diagram dcb_address
OPEN Prepares a DCB for I/O processing.
Read syntax diagramSkip visual syntax diagram ( dcb_address , (INPUT)(INOUT)(OUTPUT)(OUTIN)(RDBACK)(EXTEND)(UPDATE)(REREAD) ) ,TYPE=J
POINT Manages data set positioning.
Read syntax diagramSkip visual syntax diagram dcb_address , block_address
PUT Writes system-blocked data (QSAM).

PUT is supported for Locate and Move modes only.

Read syntax diagramSkip visual syntax diagram dcb_address ,area_address
PUTX Returns the updated record to the data set from which it was read (QSAM).
Read syntax diagramSkip visual syntax diagram dcb_address ,input_dcb_address
RDJFCB Obtains information from FILEDEF command about an OS/MVS data set.
Read syntax diagramSkip visual syntax diagram ( dcb_address ,(options)1 )
Notes:
  • 1 RDJFCB has the same options as OPEN.
READ (BDAM) Reads a physical input record (BDAM).
Read syntax diagramSkip visual syntax diagram decb_address , DIDKDIFDKF , dcb_address ,area_address,S,length,S,key_address,S0 , block_address
READ (BPAM and BSAM) Reads a physical input record (BSAM, BPAM).
Read syntax diagramSkip visual syntax diagram decb_address , SF , dcb_address , area_address ,length,S
RELSE No-op.

NOP

STOW Updates partitioned dataset directories.
Read syntax diagramSkip visual syntax diagram dcb_address , list_address ,ACDR
SYNADAF Provides SYNAD analysis function.
Read syntax diagramSkip visual syntax diagram ACSMETH = BDAMBPAMBSAMQSAM,PARM1=,PARM2=
SYNADRLS Releases SYNADAF message and save areas.

(no parameters)

WRITE (BDAM) Writes a physical record (BDAM).
Read syntax diagramSkip visual syntax diagram decb_name , DADIDKDAFDIFDKF , dcb_address ,area_address,S,length,S,key_address,S0 , block_address
WRITE (BPAM and BSAM) Writes a physical record (BSAM, BPAM).
Read syntax diagramSkip visual syntax diagram decb_name , SF , dcb_address , area_address ,length,S
WRITE (Create BDAM Data Set With BSAM) Writes a physical record (BSAM, BDAM).
Read syntax diagramSkip visual syntax diagram decb_name , SFSDSZ , dcb_address , area_address ,length,S
XDAP Reads or writes direct access volumes.
Read syntax diagramSkip visual syntax diagram ecb_symbol , RWIK , dcb_address , area_address , length_value ,(key_address,length_address) , blkref_address

1 CMS supports DCBs only below the 16MB line and in 24-bit addressing mode only.