Natural CICS Sample Programs

This part of the Natural CICS Interface documentation contains an overview of the Natural CICS sample programs.

It covers the following topics:

Sample Programs in Natural CICS Source Library

The following sample programs are supplied in the Natural CICS source library:

Front-End Programs

Name Language Function
XNCIFRNP Assembler Initalization program that initializes the Natural CICS environment at CICS start-up.
XNCIFRNL Assembler Front-end program for invoking Natural via EXEC CICS LINK.
XNCIFRNR Assembler Front-end program for invoking Natural via EXEC CICS RETURN IMMEDIATE.
XNCIFRNS Assembler Front-end program for invoking Natural via EXEC CICS START.
XNCIFRNX Assembler Front-end program for invoking Natural via EXEC CICS XCTL.
XNCIFRNN Assembler Front-end program for invoking Natural via EXEC CICS LINK without front-end parameters.
XNCIFRCL COBOL Front-end program for invoking Natural via EXEC CICS LINK.
XNCIFRCN COBOL This is a dummy front-end program for invoking Natural via EXEC CICS LINK for LE compliance.
XNCIFRCR COBOL Front-end program for invoking Natural via EXEC CICS RETURN IMMEDIATE.
XNCIFRCS COBOL Front-end program for invoking Natural via EXEC CICS START.
XNCIFRCX COBOL Front-end program for invoking Natural via EXEC CICS XCTL.
XNCIFRPL PL/1 Front-end program for invoking Natural via EXEC CICS LINK.
XNCIFRPN PL/1 This is a dummy front-end program for invoking Natural via EXEC CICS LINK for LE compliance.
XNCIFRPR PL/1 Front-end program for invoking Natural via EXEC CICS RETURN IMMEDIATE.
XNCIFRPS PL/1 Front-end program for invoking Natural via EXEC CICS START.
XNCIFRPX PL/1 Front-end program for invoking Natural via EXEC CICS XCTL.
XNCIFRDN C This is the dummy front-end program for invoking Natural via EXEC CICS LOAD and BASR for LE compliance.

Back-End Programs

Name Language Function
XNCIBACK Assembler Termination Data Dump: This back-end program displays the Natural termination message and any termination data in dump format. If invoked from an asynchronous task, the Natural termination message will be issued on the operator console, and potential termination data will be dumped. NCIBACK can also be invoked by a back-end transaction (RET=xxxx or RTI=xxxx or STR=xxxx, where xxxx is the transaction code associated with XNCIBACK).

User Exits

Name Language Function
XNCIDIRX Assembler System Directory Module Name Exit: This source module contains a sample system directory module name exit (see also NCIDIREX - System Directory Module Name Exit Interface).
XNCIDTPX Assembler DTP Terminal Exit: This source module contains a sample DTP terminal exit (see also NCIDTPEX - DTP Terminal I/O Exit Interface).
XNCIRDC1 Assembler Exit for SYSRDC: This program provides a sample exit for the SYSRDC utility; see the relevant section in the Utilities documentation.
XNCITIDX Assembler Terminal ID Exit: This program provides a sample user exit to test the terminal ID and/or to set a logical terminal or session ID (see also NCITIDEX - Terminal ID Exit Interface).
XNCITIOX Assembler DTP Terminal Exit: This source module contains a terminal I/O exit that is more general than the XNCIDTPX sample (see also NCIDTPEX - DTP Terminal I/O Exit Interface).
XNCIUIDX Assembler User ID Exit: This program provides a sample user exit to test/set the user ID (see also NCIUIDEX User ID Exit Interface).
XNCIXIDX Assembler Transaction ID Exit: This program provides a sample user exit to test/set the pseudo-conversational transaction ID (see also NCIXIDEX Transaction ID Exit Interface).

Subprogram Calls

Name Language Function
XNCI3GC1 COBOL This program provides a sample COBOL call to a Natural subprogram under CICS.
XNCI3GC2 COBOL This program provides a sample COBOL call to a Natural subprogram under CICS.
XNCI3GC3 COBOL This program provides a sample COBOL call to a Natural subprogram under CICS.
XNCI3GP1 PL/1 This program provides a sample PL/1 call to a Natural subprogram under CICS.
XNCI3GP2 PL/1 This program provides a sample PL/1 call to a Natural subprogram under CICS.
XNCI3GP3 PL/1 This program provides a sample PL/1 call to a Natural subprogram under CICS

Node Error Programs

Name Language Function
XNCINEP1 Assembler This node error program calls NCIZNEP using the CICS macro level.
XNCINEP2 Assembler This node error program calls NCIZNEP using the CICS command level.

Other Programs

Name Language Function
XNCIUCTR Assembler Upper/lower case switch: This program serves to switch the terminal into upper/lower case mode.
XNCIGNIT Assembler

"Good Night" program: This sample program calls NCIZNEP for Natural session clean-up.

Sample Programs for Use with z/VSE

For z/VSE, the sample programs written in Assembler are supplied as A books. The sample programs written in COBOL are supplied as C books. The sample programs written in PL/1 are supplied as P books. The sample programs written in C are supplied as H books.