Using RETURN to pass data

These examples demonstrate how a RETURN command is used to pass data to a new transaction.

About this task

Figures Figure 1 to Figure 4 show how a RETURN command is used in COBOL, C, C++, PL/I, and assembler language.

These examples show data being returned in a COMMAREA. For an example of a RETURN command that uses a channel to return data, see Transferring data between programs using channels.

Figure 1. RETURN command: COBOL example
 Invoking program
IDENTIFICATION DIVISION.
PROGRAM-ID. 'PROG1'..
WORKING-STORAGE SECTION.
01 TERMINAL-STORAGE.
02 FIELD PICTURE X(3).
02 DATAFLD PICTURE X(17)..
PROCEDURE DIVISION.
MOVE 'XYZ' TO FIELD.
EXEC CICS RETURN TRANSID('TRN2')
COMMAREA(TERMINAL-STORAGE)
LENGTH(20) END-EXEC..
Invoked program
IDENTIFICATION DIVISION.
PROGRAM-ID. 'PROG2'.
LINKAGE SECTION.
01 DFHCOMMAREA.
02 FIELD PICTURE X(3).
02 DATAFLD PICTURE X(17)..
PROCEDURE DIVISION.
IF EIBCALEN GREATER ZERO
THEN
IF FIELD EQUALS 'XYZ'
MOVE 'ABC' TO FIELD.
EXEC CICS RETURN END-EXEC.
Figure 2. RETURN command: C example
 Invoking program
struct ter_struct
{
unsigned char field[3];
unsigned char datafld[17];
};
main()
{
struct ter_struct ter_stor;
memcpy(ter_stor.field,"XYZ",3);
EXEC CICS RETURN TRANSID("TRN2")
COMMAREA(&ter_stor)
LENGTH(sizeof(ter_stor));
}
Invoked program
struct term_struct
{
unsigned char field[3];
unsigned char datafld[17];
};
main()
{
struct term_struct *commarea;
EXEC CICS ADDRESS COMMAREA(commarea) EIB(dfheiptr);
if (dfheiptr->eibcalen > 0)
{
if (memcmp(commarea->field, "XYZ", 3) == 0)
memcpy(commarea->field, "ABC", 3);
}
EXEC CICS RETURN;
}
Figure 3. RETURN command: PL/I example
 Invoking program
PROG1: PROC OPTIONS(MAIN);
DCL 1 TERM_STORAGE,
2 FIELD CHAR(3),.
FIELD='XYZ';
EXEC CICS RETURN TRANSID('TRN2')
COMMAREA(TERM_STORAGE);
END;
Invoked program
PROG2:
PROC(TERM_STG_PTR) OPTIONS(MAIN);
DCL TERM_STG_PTR PTR;
DCL 1 TERM_STORAGE
BASED(TERM_STG_PTR),
2 FIELD CHAR(3),.
IF EIBCALEN>0 THEN DO;
IF FIELD='XYZ' THEN FIELD='ABC';
END;
EXEC CICS RETURN;
END;
Figure 4. RETURN command: assembler language example
 Invoking program
 
DFHEISTG DSECT
TERMSTG DS 0CL20
FIELD DS CL3
DATAFLD DS CL17
⋮
PROG1 CSECT
⋮
MVC FIELD,=C'ABC'
EXEC CICS RETURN
TRANSID('TRN2')
COMMAREA(TERMSTG)
⋮
END
 
Invoked program
 
TERMSTG DSECT
FIELD DS CL3
DATAFLD DS CL17
⋮
PROG2 CSECT
⋮
CLC EIBCALEN,=H'0'
BNH LABEL2
L COMPTR,DFHEICAP
USING TERMSTG,COMPTR
CLC FIELD,=C'XYZ'
BNE LABEL1
MVC FIELD,=C'ABC'
LABEL1 DS 0H
⋮
LABEL2 DS 0H
⋮
END


dfhp3uv.html | Timestamp icon Last updated: Monday, 5 June 2017