SELMBR SELECT DATA BASE MEMBER TAADBJR |
The Select Data Base Member command provides a display of designated
members within a file and allows the user to select one. A return
field describes the selected member. The command is designed for use
as a sub function in an application where the user wants to select
from a list of members. The DMOSELMBR command may be used to try a
demonstration of the function.
To try the demo, against all members in QCLSRC, enter:
DMOSELMBR FILE(QCLSRC)
The SELMBR command returns a variable and therefore may only be used
in a CL program such as:
DCL &RTNMBR *CHAR LEN(10)
.
SELMBR FILE(...) MBR(...) RTNMBR(&RTNMBR)
SELMBR escape messages you can monitor for
------------------------------------------
TAA9891 F3 or F12 was used to end SELMBR
TAA9892 The member does not exist
Escape messages from based on functions will be re-sent.
SELMBR Command parameters *CMD
-------------------------
FILE The qualified name of a data base file to be
displayed. A specific file name must be entered.
The library defaults to *LIBL. *CURLIB may be used.
MBR The member name to display. The default is *ALL. A
specific name or a generic name may be entered.
RTNMBR The member (if any) selected by the user. The
return variable is required and must be specified as
*CHAR LEN(10).
If the user does not select a member, escape
messages TAA9891 or TAA9892 will be returned.
DMOSELMBR Command parameters *CMD
----------------------------
FILE The qualified name of a data base file to be
displayed. A specific file name must be entered.
The library defaults to *LIBL. *CURLIB may be used.
MBR The member name to display. The default is *ALL. A
specific name or a generic name may be entered.
Restrictions
------------
Because SELMBR returns a variable, it may only be used in a CL
program and must be used in an interactive job.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CHKOBJ3 Check object 3
DSPMBRD Display member description
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
TAAEXC TAA Execute command
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SELMBR *CMD TAADBJR QATTCMD
DMOSELMBR *CMD TAADBJR2 QATTCMD
TAADBJRC *PGM CLP TAADBJRC QATTCL
TAADBJRC2 *PGM CLP TAADBJRC2 QATTCL
TAADBJRR *PGM RPG TAADBJRR QATTRPG
TAADBJRD *FILE DSPF TAADBJRD QATTDDS
Structure
---------
SELMBR Cmd
TAADBJRC CL pgm
TAADBJRR RPG Pgm
TAADBJRD Display file
DMOSELMBR Cmd
TAADBJRC2 CL pgm
|
Added to TAA Productivity tools March 15, 2002