Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### EPLIST

Prolog

Control Block Contents
EPLIST DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### EPLIST Prolog

     Name       : EPLIST
     Description: Extended Parameter List DSECT
     DSECT      : EPLIST
     Function   : EPLIST maps the extended parameter list passed
                  between modules. EPLIST is found in the EPLIST
                  macro.

#### EPLIST Control Block Content

#### EPLIST DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      EPLIST
    0000    0 Address      4 EPLCMD         ADDRESS OF COMMAND TOKEN.
    0004    4 Address      4 EPLARGBG       ADDR OF BEGINNING OF ARGUMENTS.
    0008    8 Address      4 EPLARGND       ADDR OF END OF ARGUMENTS.
    000C   12 Address      4 EPLUWORD       USER WORD
              00000010       EPL4LNBY       *-EPLIST 4 WORD HEADER LENGTH IN
                                            BYTES
              00000002       EPL4LNDW       (*-EPLIST+7)/8 4 WORD HEADER
                                            LENGTH IN DWORDS
    0010   16 Address      4 EPARGLST       ADDRESS OF FUNCTION ARGUMENT
                                            LIST.
    0014   20 Address      4 EPFUNRET       ADDRESS FOR RETURN OF FUNCTION
                                            DATA.
              00000018       EPL6LNBY       *-EPLIST 6 WORD HEADER LENGTH IN
                                            BYTES
              00000003       EPL6LNDW       (*-EPLIST+7)/8 6 WORD HEADER
                                            LENGTH IN DWORDS
    0018   24 Address      4 * (2)          PADDING (FOR USE WITH SCAN MACRO)
    0020   32 Character    8 EPLSCANT (0)   BEGINNING OF TOKENIZED PLIST
                                            BUILT BY SCAN MACRO.
              0000000C       EPLRSRVD       EPLUWORD,4,C'A' (OLD NAME, FOR
                                            COMPATIBILITY) THE EXTENDED PLIST
                                            FLAGS INDICATE THE PRESENCE OF AN
                                            EXTENDED PLIST IN REGISTER 0. THE
                                            HIGH ORDER BYTE OF REGISTER 1
                                            WILL CONTAIN EITHER EPLCMDFL OR
                                            EPLFNCFL TO INDICATE THE EXTENDED
                                            PLIST IS AVAILABLE. ONLY THE
                                            FIRST 4 WORDS OF THE EXTENDED
                                            PLIST ARE AVAILABLE WITH THESE
                                            CODES. IF THE HIGH ORDER BYTE OF
                                            REGISTER 1 CONTAINS EPFUNSUB,
                                            THEN THE INVOCATION IS AN
                                            EXTERNAL FUNCTION/SUBROUTINE CALL
                                            FROM REX. WITH THIS PLIST, ALL 6
                                            WORDS OF THE PLIST ARE AVAILABLE.
                                            WORD 5 POINTS TO A LIST OF DOUBLE
                                            WORD ADLENS (ADDRESS-LENGTH
                                            PAIRS) WHICH DESCRIBE THE
                                            ARGUMENTS TO THE ROUTINE
                                            (EPARGLST). WORD 6 (EPFUNRET) IS
                                            THE LOCATION FOR THE CALLED
                                            ROUTINE TO STORE THE ADDRESS OF
                                            AN EVALBLOK TO RETURN DATA TO THE
                                            CALLING PROGRAM.
              .... 1.11      EPLCMDFL       X'0B' EXTENDED PLIST AVAILABLE
                                            FLAG.
              .... ...1      EPLFNCFL       X'01' EXTENDED PLIST AVAILABLE
                                            FLAG.
              .... .1.1      EPFUNSUB       X'05' EXTERNAL FUNCTION PLIST
                                            AVAILABLE FLAG DEFINITIONS.
                                            EXCEPT AS NOTED, ONLY THE FIRST
                                            FOUR WORDS OF THE EXTENDED PLIST
                                            ARE AVAILABLE. EPLIST FLAG VALUE
                                            AVAIL? MEANING
              .... ....      EPLFPROG       X'00' N PROGRAM
              .... ...1      EPLFCMND       X'01' Y ADDRESS COMMAND
              .... ..1.      EPLFSBCM       X'02' Y SUBCOM
              .... ..11      EPLFNNUE       X'03' Y NO NUCEXT, EXTENDED
              .... .1..      EPLFNNUT       X'04' N NO NUCEXT, TOKENIZED
              .... .1.1      EPLFRXFN       X'05' Y REXX EXTERNAL FUNCTION, 6
                                            WORD EXTENDED PLIST PRESENT
              .... .11.      EPLFIMMD       X'06' Y IMMEDIATE COMMAND
              .... 1.11      EPLFSRCH       X'0B' Y COMMAND SEARCH
              ...1 ....      EPLFEXEC       X'10' N INVOKED BY BPX1EXC
              1111 111.      EPLFENDC       X'FE' N END OF COMMAND
              1111 1111      EPLFABEN       X'FF' N ABEND OR NUCXDROP

#### EPLIST Storage Layout

    *** EPLIST - Control Block in EPLIST
    *
    *     +---------------------------+---------------------------+
    *   0 |          EPLCMD           |         EPLARGBG          |
    *     +---------------------------+---------------------------+
    *   8 |         EPLARGND          |         EPLUWORD          |
    *     +---------------------------+---------------------------+
    *  10 |         EPARGLST          |         EPFUNRET          |
    *     +---------------------------+---------------------------+
    *  18 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *
    *** EPLIST - Control Block in EPLIST

#### EPLIST Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    EPARGLST       0010
    EPFUNRET       0014
    EPFUNSUB       0020 05
    EPLARGBG       0004
    EPLARGND       0008
    EPLCMD         0000
    EPLCMDFL       0020 0B
    EPLFABEN       0020 FF
    EPLFCMND       0020 01
    EPLFENDC       0020 FE
    EPLFEXEC       0020 10
    EPLFIMMD       0020 06
    EPLFNCFL       0020 01
    EPLFNNUE       0020 03
    EPLFNNUT       0020 04
    EPLFPROG       0020 00
    EPLFRXFN       0020 05
    EPLFSBCM       0020 02
    EPLFSRCH       0020 0B
    EPLRSRVD       0020 0000000C
    EPLSCANT       0020
    EPLUWORD       000C
    EPL4LNBY       000C 00000010
    EPL4LNDW       000C 00000002
    EPL6LNBY       0014 00000018
    EPL6LNDW       0014 00000003

This information is based on z/VM V4R4.0.
Last updated on 28 Jul 2003 at 08:14:40 EDT.
Copyright IBM Corporation, 1990, 2003