IEDTGET - Read work file-specific parameter settings

The IEDTGET function can be used to read the specific parameter settings for a work file. One of the following values must be entered in the EAMFILE field of control block EDTAMCB.

L0..L22 (work file 0..22)

The values must be left-aligned and padded with blanks.
The length of the control block EDTPARL no longer has to be entered in the field EAMPREC (EDTAMCB) since the length of the output is unambiguously defined by the EDTPARL version. Similarly, no values are entered for EAMLREC on return.
EDT stores the information in the EDTPARL control block (see section “EDTPARL - Work file specific parameter settings”).

Call

The following specifications are required (see overview):

• Entry of values in the required fields in the EDTGLCB and EDTUPCB control blocks.

• Specification of the initialized EDTPARL control block

• Call of the entry point address IEDTGET with the parameter list

Overview

(For the control blocks, see section “Generation and structure of the control blocks”).

Entry point address     :     IEDTGET

Parameter list         :     A (EDTGLCB, EDTAMCB, EDTKEY1, EDTKEY,

EDTPARL)

Any values can be entered for the buffers EDTKEY1 and EDTKEY as these are not evaluated.

Call parameter		Return parameter
EDTGLCB:	EGLUNIT EGLVERS	EDTGLCB:	EGLRETC EGLRMSG
EDTAMCB:	EAMUNIT EAMVERS EAMFILE	EDTPARL
EDTPARL:	EPLUNIT EPLVERS

Return codes on status query

EGLMRET	EGLSR1
EAMRETOK EAMACERR EAMPAERR EAMPAERR EAMPAERR EAMPAERR EAMPAERR	EAMOK00 EAMAC12 EAMPA04 EAMPA08 EAMPA12 EAMPA32 EAMPA36

If the call is successful (return code is EAMRETOK/EAMOK00) then the information is entered in control block EDTPARL.

For the meaning of the return codes, see section “EDTGLCB - Global EDT control block”.

If the call is not successful, the control block EDTPARL remains unchanged.

Call in the C program

Required include files:

#include <stdio.h>

#include <iedtgle.h>

The EDTAMCB control block is declared and initialized as follows:

iedamcb amcb = IEDAMCB_INIT;
iedparl parl = IEDPARL_INIT; 
strncpy(amcb.filename,"L1      ",8);

In the C program, the IEDTGET function for reading the work file-specific parameter settings is called as follows:

IEDTGET(&glcb,&amcb,NULL,NULL,&parl);