Previous Topic

Next Topic

Book Contents

Book Index

Syntax

The standard format of the IOAENV macro is shown below.

Syntax for IOAENV Macro

=============================================================================                                                    

name    symbol. Begin name in column 1. One or more blanks must precede IOAENV

IOAENV  One or more blanks must follow IOAENV

=============================================================================

INIT                          Build MCT.

SERV[,MCTADDR=field]          Add services/xxxPARMs.

REFR[,MCTADDR=field]          Refresh xxxPARM (except IOAPARM). Delete the loaded xxxPARM and load it again.

TERM[,MCTADDR=field]          Delete all loaded xxxPARMs and terminate all initialized services.

                              If MCTADDR is omitted, then we assume to have addressability for the MCT.

                              Note:  Only one MCT is handled by the macro. If it does not exist,then one is built.

,PARMS=     p                 Parameter letter.

           (p1,p2,..,pn)      Parameter letters.

           area               An area within the program that contains pairs of parameter letter and parameter suffix. For example:

                              area DC C’M3D5R8’,X’FF’

                              (use CTMPARM3; CTDPARM5; CTRPARM8)

                              Note: Each xxxPARM is loaded (with IOALDPRM) and it’s address is saved in the MCT. For IOA, CTM,

                              CTD, CTR and ECS the fixed part of the loaded xxxPARM is copied to the MCT.

,PLEX=      p                 xxxPLEX letter.

            (p1,p2,..,pn)     xxxPLEX letters.

            area              An area within the program that contains pairs of plex letter and plex suffix.

                              Note Each xxxPLEX is loaded (with IOALDPRM) and it’s address s saved ina table of addresses. The address of this table is saved in MCTPLEXT field.    

,CMEM=     YES/NO   If CMEM=YES then CMMPARM is loaded if Control‑O is NOT installed

,MSG=      YES/NO             Initialize the messages environment.

,WISH=     YES/NO             Initialize the optional wishes environment.

,TRACE=    YES/NO             Initialize trace options.

,LOG=      NO                 LOG not required.

           LOG                Open LOG.

           CHN                Open LOG-in-MEMORY for 500 records.

,MCT=      Rx                 Default: R12

                              NONE Unless MCT=NONE is coded, on return from INIT function the following commands are generated:

                              LR Rx,R1

                              USING MCTSTART,Rx

,LOC=      BELOW/ANY          Where all the GETMAIN(s) needed for the services will be done

,ERRET=    label              Label of error routine (see return codes).

                              If ERRET is omitted, an ABEND will be used.

,DUMP=     YES/NO             Isssue IOADUMP macro.

                              This macro issues ESTAE and prints mini-dump at ABEND time.

,ALLOC=                       (a1,a2,..,an) List of Allocation Member Names.

,FREE=                        (f1,f2,..,fn)List of Allocation Member Names.

,SP=       sp                  A one byte area containing the subpool number

                               If omitted, the default (132) is used

,RAREA=    area                Support area for PARMS/PLEX in reentrant programs.

Parent Topic

IOAENV Assembler Macro