Progress0 of 0 lessons

CICS SEND - Send

CICS SEND provides send management capabilities, enabling send processing and output processing in CICS environments. It provides efficient send capabilities for CICS applications.

What is CICS SEND?

CICS SEND provides send management capabilities, enabling send processing and output processing. It provides efficient send capabilities, allowing applications to manage send operations.

Command Syntax

cobol
1
2
3
4
EXEC CICS SEND
    [RESP(response-code)]
    [RESP2(response-code-2)]
END-EXEC.

Parameters Explained

RESP Parameters

Response codes returned by the command:

  • RESP: Primary response code - indicates the success or failure of the send operation
  • RESP2: Secondary response code - provides additional error information when RESP indicates failure
  • Always check these codes for command success before proceeding with data processing
  • Handle command failures appropriately to prevent application errors

Send Types

1. Basic Sends

  • Basic sends: Standard send operations that handle simple sending without special formatting
  • Mapped sends: Send operations that use predefined field mappings to structure send data
  • Unmapped sends: Raw send operations that handle unstructured sending without predefined field mappings
  • Custom sends: Specialized send operations designed for specific application requirements

2. Advanced Sends

  • Advanced sends: Complex send operations that handle sophisticated sending processing and validation
  • Secure sends: Send operations that include encryption and security features for sensitive sending
  • Encrypted sends: Send operations that automatically encrypt send data
  • Compressed sends: Send operations that handle compressed sending streams and automatically compress send data

3. Specialized Sends

  • Specialized sends: Send operations tailored for specific protocols or communication methods
  • High-performance sends: Optimized send operations designed for maximum throughput and efficiency
  • Low-latency sends: Send operations optimized for minimal delay and real-time processing requirements
  • High-throughput sends: Send operations designed to handle large volumes of sending efficiently

Implementation Example

cobol
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
WORKING-STORAGE SECTION.
01 WS-RESPONSE            PIC S9(8) COMP.
01 WS-RESPONSE2           PIC S9(8) COMP.
 
PROCEDURE DIVISION.
    * Send operation
    EXEC CICS SEND
        RESP(WS-RESPONSE)
        RESP2(WS-RESPONSE2)
    END-EXEC.
    
    IF WS-RESPONSE NOT EQUAL DFHRESP(NORMAL)
        EXEC CICS WRITE OPERATOR
            TEXT('SEND command failed')
        END-EXEC
        EXEC CICS RETURN END-EXEC
    END-IF.
    
    * Send operation completed successfully
    * Continue processing

Send Processing

1. Send Preparation

Send preparation includes:

  • Send validation - ensuring the send operation is properly configured and authorized
  • Send formatting - preparing data structures and buffers for send data
  • Send encoding - setting up proper character encoding and data transformation
  • Send processing - initializing the send operation and preparing for sending

2. Send Transmission

Send transmission includes:

  • Send routing - directing send data to the appropriate processing location
  • Send delivery - ensuring send data reaches the correct destination within the application
  • Transmission confirmation - verifying that send was completed successfully
  • Error handling - managing transmission failures and implementing retry mechanisms

3. Output Management

Output management includes:

  • User management - handling user sessions and maintaining connection state
  • Output formatting - structuring send data for presentation or further processing
  • User experience - ensuring smooth data flow and responsive application behavior
  • Performance optimization - maximizing send efficiency and minimizing resource usage

Common Response Codes

Success Response Codes

  • NORMAL (0): Send operation completed successfully - sending was completed without errors
  • SEND (4): Send operation completed - operation completed with send-specific status

Error Response Codes

  • INVREQ (16): Invalid request - the send operation parameters are incorrect or unauthorized
  • NOTFND (20): Resource not found - the specified send resource does not exist
  • LENGERR (22): Length error - the send data length exceeds expected limits
  • SEND (24): Send error - a send-specific error occurred during the operation

Best Practices

1. Send Preparation

  • Prepare send appropriately - ensure all necessary resources and configurations are in place
  • Validate send content - verify that send data meets expected format and quality standards
  • Handle different send types - implement flexible processing to accommodate various sending formats
  • Ensure send integrity - maintain data consistency and prevent corruption during sending

2. Error Handling

  • Check all response codes - always examine both RESP and RESP2 for complete error information
  • Handle send failures - implement appropriate recovery mechanisms for failed send operations
  • Implement retry logic - provide automatic retry capabilities for transient failures
  • Log error conditions - maintain detailed logs for troubleshooting and monitoring purposes

3. Performance Optimization

  • Minimize send operations - reduce unnecessary send calls to improve overall performance
  • Use efficient send formats - choose appropriate data formats to minimize processing overhead
  • Optimize user updates - streamline user interface updates to reduce response time
  • Manage user resources - efficiently allocate and manage system resources for send operations

Explain It Like I'm 5 Years Old

Imagine you're sending a message:

When you want to send a message, you write it down and send it. If you send it, it goes to the person. If you don't send it, it stays with you.

CICS SEND is like sending a message. The computer program writes data and sends it. If it sends it, it goes to the right place. If it doesn't send it, it stays with the program.

Just like you send messages, the computer program sends data!

Exercises

Exercise 1: Send Operation

Write a CICS SEND command to perform a send operation.

cobol
1
2
3
4
EXEC CICS SEND
    RESP(WS-RESPONSE)
    RESP2(WS-RESPONSE2)
END-EXEC.

Exercise 2: Send Processing

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

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

Quiz

Question 1

What is the primary purpose of CICS SEND?

Answer: B) To provide send management capabilities

Question 2

Which parameter specifies the response code?

Answer: A) RESP

Related Concepts

CICS Send Processing

Send processing and output in CICS

CICS User Management

User management and user interaction in CICS

CICS Output Processing

Output processing and send display in CICS