IEDTGET - Read the global parameter settings

The IEDTGET function can be used to read information concerning the global EDT parameter settings. For this to be possible, the value G must be entered in the EAMFILE field of control block EDTAMCB (left-aligned and padded with blanks).

If the V17 format of the control block is used, it is no longer necessary to enter the length of the control block EDTPARG in the field EAMPREC (EDTAMCB) since the length of the output is unambiguously defined by the EDTPARG version. Similarly, no values are entered for EAMLREC on return.

EDT stores the information in the EDTPARG control block (see section “EDTPARG - Global parameter settings”).

Call

The following specifications are required (see overview):

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

• Specification of the initialized EDTPARG control block as the output area

• 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,

EDTPARG)

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	EDTPARG
EDTPARG:	EPGUNIT EPGVERS

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 the control block EDTPARG.

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

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

Call in the C program

Required include files:

#include <stdio.h>

#include <iedtgle.h>

The control blocks EDTAMCB and EDTPARG are declared and initialized as follows:

iedamcb amcb = IEDAMCB_INIT;
iedparg parg = IEDPARG_INIT; 
strncpy(amcb.filename,"G       ", 8);

In the C program, the IEDTGET function for reading the global parameter settings is called as follows:

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