How do you use CICS SEND (APPC)?

Use CICS SEND (APPC) with FROM and LENGTH parameters to specify the data, optionally include TO parameter for partner identification, check response codes, and handle any errors appropriately.

What are the different types of APPC data?

APPC data types include text data (plain text, formatted text, marked text, rich text), binary data (binary data, encoded data, compressed data, encrypted data), and structured data (structured data, table data, list data, detail data).

When should you use CICS SEND (APPC)?

Use CICS SEND (APPC) when building applications that need to send data to APPC partners, when implementing APPC data transmission, when sending data to partners, when building APPC data output systems, or when implementing APPC data transmission functionality.

CICS SEND (APPC) - APPC Data Sending

CICS SEND (APPC) transmits data to APPC partners, enabling APPC data transmission and output processing in CICS environments. It provides efficient APPC data sending capabilities for CICS applications.

What is CICS SEND (APPC)?

CICS SEND (APPC) transmits data to APPC partners, enabling APPC data transmission and output processing. It provides efficient APPC data sending capabilities, allowing applications to send data directly to APPC partners.

Command Syntax

cobol

1
2
3
4
5
6
7
EXEC CICS SEND
    FROM(data-area)
    LENGTH(length-value)
    [TO(partner-id)]
    [RESP(response-code)]
    [RESP2(response-code-2)]
END-EXEC.

Parameters Explained

FROM Parameter

Specifies the data area to send:

Must contain data to send
Contains outgoing data
Required for all SEND operations
Must be properly aligned

LENGTH Parameter

Specifies the length of the data:

Must match actual data length
Used for data transmission
Required for all SEND operations
Prevents buffer overflow

TO Parameter

Specifies the destination partner:

Optional parameter
Identifies specific partner
Used for partner-specific operations
Can be omitted for default partner

RESP Parameters

Response codes returned by the command:

RESP: Primary response code
RESP2: Secondary response code
Always check these codes for command success
Handle command failures appropriately

APPC Data Types

1. Text Data

Plain text: Plain text data
Formatted text: Formatted text data
Marked text: Marked text data
Rich text: Rich text data

2. Binary Data

Binary data: Binary data
Encoded data: Encoded data
Compressed data: Compressed data
Encrypted data: Encrypted data

3. Structured Data

Structured data: Structured data
Table data: Table data
List data: List data
Detail data: Detail data

Implementation Example

cobol

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
WORKING-STORAGE SECTION.
01 WS-RESPONSE            PIC S9(8) COMP.
01 WS-RESPONSE2           PIC S9(8) COMP.
01 WS-DATA-LENGTH         PIC S9(8) COMP VALUE 256.
01 WS-DATA-AREA           PIC X(256) VALUE 
    'This is data to be sent to APPC partner.'.
01 WS-PARTNER-ID          PIC X(8) VALUE 'PARTNER1'.
 
PROCEDURE DIVISION.
    * Send data to APPC partner
    EXEC CICS SEND
        FROM(WS-DATA-AREA)
        LENGTH(WS-DATA-LENGTH)
        TO(WS-PARTNER-ID)
        RESP(WS-RESPONSE)
        RESP2(WS-RESPONSE2)
    END-EXEC.
    
    IF WS-RESPONSE NOT EQUAL DFHRESP(NORMAL)
        EXEC CICS WRITE OPERATOR
            TEXT('SEND (APPC) command failed')
        END-EXEC
        EXEC CICS RETURN END-EXEC
    END-IF.
    
    * Data sent successfully
    * Continue processing

APPC Data Processing

1. Data Preparation

Data preparation includes:

Data validation
Data formatting
Data encoding
Data processing

2. Data Transmission

Data transmission includes:

Data routing
Data delivery
Transmission confirmation
Error handling

3. Output Management

Output management includes:

Partner management
Output formatting
User experience
Performance optimization

Common Response Codes

Success Response Codes

NORMAL (0): Data sent successfully
SEND (4): Data transmitted

Error Response Codes

INVREQ (16): Invalid request
NOTFND (20): Partner not found
LENGERR (22): Length error
SEND (24): Send error

Best Practices

1. Data Preparation

Prepare data appropriately
Validate data content
Handle different data types
Ensure data integrity

2. Error Handling

Check all response codes
Handle send failures
Implement retry logic
Log error conditions

3. Performance Optimization

Minimize data transmission
Use efficient data formats
Optimize partner updates
Manage partner resources

Explain It Like I'm 5 Years Old

Imagine you're sending a message to a friend:

When you want to send a message to a friend, you write down your message and then give it to them. The message contains your words and thoughts that you want to share.

CICS SEND (APPC) is like sending a message to a friend. The computer program takes some data (like your message) and sends it to where it needs to go, so the person can read it and understand what you're trying to tell them.

Just like you send messages to communicate with your friends, the computer program sends data to communicate with partners!

Exercises

Exercise 1: Data Transmission

Write a CICS SEND (APPC) command to send data to an APPC partner.

cobol

1
2
3
4
5
6
7
EXEC CICS SEND
    FROM(WS-DATA-AREA)
    LENGTH(WS-DATA-LENGTH)
    TO(WS-PARTNER-ID)
    RESP(WS-RESPONSE)
    RESP2(WS-RESPONSE2)
END-EXEC.

Exercise 2: Data Processing

How would you implement comprehensive data processing that handles different data types and partner requirements?

Answer: Identify different data types and appropriate handling, implement data validation and encoding, handle different partner types and capabilities, implement proper error handling for data transmission failures, optimize data transmission for performance, and maintain data integrity throughout the process.

Quiz

Question 1

What is the primary purpose of CICS SEND (APPC)?

A) To format dataB) To send data to APPC partnersC) To validate dataD) To edit data

Answer: B) To send data to APPC partners

Question 2

Which parameter specifies the data area to send?

A) FROMB) DATAC) SENDD) MESSAGE

Answer: A) FROM

CICS SEND (APPC) - APPC Data Sending

What is CICS SEND (APPC)?

Command Syntax

Parameters Explained

FROM Parameter

LENGTH Parameter

TO Parameter

RESP Parameters

APPC Data Types

1. Text Data

2. Binary Data

3. Structured Data

Implementation Example

APPC Data Processing

1. Data Preparation

2. Data Transmission

3. Output Management

Common Response Codes

Success Response Codes

Error Response Codes

Best Practices

1. Data Preparation

2. Error Handling

3. Performance Optimization

Explain It Like I'm 5 Years Old

Exercises

Exercise 1: Data Transmission

Exercise 2: Data Processing

Quiz

Question 1

Question 2

Related Concepts

CICS APPC Data Processing

CICS Partner Management

CICS Output Processing

Related Pages