EVORXGET - Read a PDS Member - ironstream_for_servicenow_discovery_1 - 7.5

Ironstream for ServiceNow® Discovery for IBM Z® Administration

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for ServiceNow® Discovery
Version
7.5
Language
English
Product name
Ironstream for ServiceNow® Discovery for IBM Z®
Title
Ironstream for ServiceNow® Discovery for IBM Z® Administration
First publish date
2007
Last updated
2024-11-18
Published on
2024-11-18T05:02:12.928000
Description This function will read a member of a PDS and return the records in the 'variable_name' specified as a compound variable (e.g., PDSRECD.1). The 'ddname' must be pre-allocated prior to invocation of the function. The '0' stem of the ‘variable_name' will contain the number of records read. The 'count' field is optional and will default to a maximum of 9,999 records.
Syntax

EVORXGET('member','ddname','returnmsg'[,linecount])

where:
member  The member name of a partitioned dataset (1 to 8 characters)
ddname  An existing symbolic DD name (1 to 8 characters)
returnmsg  A 1-to-17-character variable name that will be used as a compound variable containing the lines (records) read from the dataset
linecount  The maximum number of records to be read. The default is 9999 records.
Return Value
A variable can be assigned to the command to hold one of these return texts:
OK The read was successful
ERROR IN SPECIFYING READ FUNCTION Invalid parameter(s) specified
ERROR OPENING PDS DATASET The ddname pointed to a non-partitioned dataset
STORAGE REQUEST FAILED Temporary memory allocation failed
MEMBER REQUESTED NOT_FOUND member was not found in the ddname dataset
REXX Example

This example opens a dataset member and reads JCL records. The records are written to an allocated internal reader to allow the JCL to be submitted as a job.

/*REXX*/

/* Allocate my JCL dataset to the "INPUT" DDname */

if EVORXALO('INPUT','USER.JCL.CNTL') = 'OK' then

do

/* Allocate the internal reader */

if EVORXINT('JCLOUT') = 'OK' then

do

/* Read the PDS member and write it to the internal reader */

REXX Example

if EVORXGET('IEFBR14','INPUT','PDSRECD') = 'OK' then

do

"EXECIO 0 DISKW JCLOUT (OPEN"

"EXECIO * DISKW JCLOUT (STEM PDSRECD. FINIS"

say 'IEFBR14 submitted'

end

/* Free the allocated dataset */

x = EVORXFRE('JCLOUT')

end

x = EVORXFRE('INPUT')

end

exit