Natural CICS Sample Programs

#### Search Results

Search

# Natural CICS Sample Programs

This document contains an overview of the Natural CICS sample programs.

It covers the following topics:

- Sample Programs in Natural CICS Source Library

## Sample Programs in Natural CICS Source Library

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

- Front-End Programs

- Back-End Programs

- User Exits

- Subprogram Calls

- Other Programs

### 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

### Other Programs

Name | Language | Function
--- | --- | ---
`XNCIUCTR` | Assembler | Upper/lower case switch: This program serves to switch the terminal into upper/lower case mode.
`XNCINEP2` | Assembler | This node error program calls the `NCIZNEP` module.
`XNCIGNIT` | Assembler | "Good night" program: This sample program calls the `NCIZNEP` module for Natural session cleanup.
`XNCITRPX` | Assembler | Debugging aid: If necessary for error diagnosis, Software AG technical support personnel will advise you of the usage of this program.