RLS

Read syntax diagramSkip visual syntax diagram>>-RLS--+-CKDIR--dirid--------------------------+--------------><
        +-DELETE--listname----------------------+
        |                 .-*QUEUE*-.           |
        +-LPULL--varname--+---------+-----------+
        |                 '-queid---'           |
        |                 .-*QUEUE*-.           |
        +-LPUSH--varname--+---------+-----------+
        |                 '-queid---'           |
        |                  .-*QUEUE*-.          |
        +-LQUEUE--varname--+---------+----------+
        |                  '-queid---'          |
        +-MKDIR--dirid--------------------------+
        |                 .-DATA.-.             |
        +-READ--listname--+-------+--+--------+-+
        |                 '-stem.-'  '-(--UPD-' |
        +-VARDROP--varname--dirid---------------+
        +-VARGET--varname--dirid----------------+
        +-VARPUT--varname--dirid----------------+
        |                  .-DATA.-----.        |
        '-WRITE--listname--+-----------+--------'
                           '-+-------+-'
                             '-stem.-'
 

RLS performs list input/output to the REXX List System.

Operands

CKDIR
is a command that checks for an existing RLS directory level.
dirid
specifies a REXX List System directory level identifier. This is partially or fully qualified. Refer to the CLD command, section CLD, for more information.
DELETE
is a command that deletes an RLS directory level or RLS list.
listname
specifies a REXX List System list identifier. This is partially or fully qualified.
LPULL
is a command that pulls a record from the top of the queue.
varname
specifies a simple REXX variable name. It does not end in a period, distinguishing a variable name from a stem name.
*QUEUE*
specifies the special default name.
queid
is the identifier for a special type of RLS list accessed by LPULL, LPUSH, or LQUEUE.
LPUSH
is a command that pushes a record onto the top of the queue (LIFO).
LQUEUE
is a command that adds a record to the end of the queue (FIFO).
MKDIR
is a command that creates a new RLS directory level.
READ
is a command that reads records from an RLS list into a stem.
listname
specifies the list identifier.
stem.
specifies the name of a stem. (A stem must end in a period.) Refer to section Stems for more information. The default stem is DATA..
UPD
enqueues on a list for update.
VARDROP
is a keyword indicating that an RLS variable is deleted.
VARGET
is a command that takes an RLS variable and copies it into a REXX variable of the same name.
VARPUT
is a command that takes a REXX variable and copies it into an RLS variable of the same name.
WRITE
is a command that writes records to an RLS list from a stem.

Return Codes

0
Normal return
701
Invalid command
702
Invalid operand
713
Directory not found
715
Directory already exists
716
Directory not specified
723
List not found
726
List not specified
728
List is in update mode
729
List is not in update mode
730
User is not signed on
732
Queue empty
733
Named queue not found
736
Stem or variable not specified
737
Stem or variable name too long
738
Stem or variable count invalid
743
Block not found
746
CICGETV error
747
GETMAIN error
748
FREEMAIN error
749
ENQ error
750
DEQ error
751
Dynamic area GETMAIN error
752
Error in saved variable data
753
Saved variable not found
754
User not owner of list