Progress0 of 0 lessons

CICS CHANGE PHRASE - Change Phrase

CICS CHANGE PHRASE changes a user phrase, enabling phrase management and output processing in CICS environments. It provides efficient phrase changing capabilities for CICS applications.

What is CICS CHANGE PHRASE?

CICS CHANGE PHRASE changes a user phrase, enabling phrase management and output processing. It provides efficient phrase changing capabilities, allowing applications to change user phrases.

Command Syntax

cobol
1
2
3
4
5
6
EXEC CICS CHANGE PHRASE
    USERID(user-id)
    PHRASE(new-phrase)
    [RESP(response-code)]
    [RESP2(response-code-2)]
END-EXEC.

Parameters Explained

USERID Parameter

Specifies the user ID to change phrase for:

  • Must be a valid user ID
  • Identifies specific user
  • Required for all CHANGE PHRASE operations
  • Must be active user

PHRASE Parameter

Specifies the new phrase:

  • Must be a valid phrase
  • Contains new phrase
  • Required for all CHANGE PHRASE operations
  • Must meet phrase requirements

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

Phrase Types

1. Basic Phrases

  • Basic phrases: Basic phrases
  • Mapped phrases: Mapped phrases
  • Unmapped phrases: Unmapped phrases
  • Custom phrases: Custom phrases

2. Advanced Phrases

  • Advanced phrases: Advanced phrases
  • Secure phrases: Secure phrases
  • Encrypted phrases: Encrypted phrases
  • Compressed phrases: Compressed phrases

3. Specialized Phrases

  • Specialized phrases: Specialized phrases
  • High-performance phrases: High-performance phrases
  • Low-latency phrases: Low-latency phrases
  • High-throughput phrases: High-throughput phrases

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
WORKING-STORAGE SECTION.
01 WS-RESPONSE            PIC S9(8) COMP.
01 WS-RESPONSE2           PIC S9(8) COMP.
01 WS-USER-ID             PIC X(8) VALUE 'USER001'.
01 WS-NEW-PHRASE          PIC X(16) VALUE 'NEWPHRASE123'.
 
PROCEDURE DIVISION.
    * Change user phrase
    EXEC CICS CHANGE PHRASE
        USERID(WS-USER-ID)
        PHRASE(WS-NEW-PHRASE)
        RESP(WS-RESPONSE)
        RESP2(WS-RESPONSE2)
    END-EXEC.
    
    IF WS-RESPONSE NOT EQUAL DFHRESP(NORMAL)
        EXEC CICS WRITE OPERATOR
            TEXT('CHANGE PHRASE command failed')
        END-EXEC
        EXEC CICS RETURN END-EXEC
    END-IF.
    
    * Phrase changed successfully
    * Continue processing

Phrase Processing

1. Phrase Preparation

Phrase preparation includes:

  • Phrase validation
  • Phrase formatting
  • Phrase encoding
  • Phrase processing

2. Phrase Transmission

Phrase transmission includes:

  • Phrase routing
  • Phrase delivery
  • Transmission confirmation
  • Error handling

3. Output Management

Output management includes:

  • User management
  • Output formatting
  • User experience
  • Performance optimization

Common Response Codes

Success Response Codes

  • NORMAL (0): Phrase changed successfully
  • CHANGE (4): Phrase changed

Error Response Codes

  • INVREQ (16): Invalid request
  • NOTFND (20): User not found
  • LENGERR (22): Length error
  • CHANGE (24): Change error

Best Practices

1. Phrase Preparation

  • Prepare phrase appropriately
  • Validate phrase content
  • Handle different phrase types
  • Ensure phrase integrity

2. Error Handling

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

3. Performance Optimization

  • Minimize phrase changing
  • Use efficient phrase formats
  • Optimize user updates
  • Manage user resources

Explain It Like I'm 5 Years Old

Imagine you're changing the secret word for your club:

When you want to change the secret word for your club, you tell everyone what the new secret word is. The new secret word is something only your club members know, so only they can use it to get into your club.

CICS CHANGE PHRASE is like changing the secret word for your club. The computer program tells everyone what the new phrase is. The new phrase is something only you know, so only you can use it to get into your account.

Just like you change the secret word for your club to keep it safe, the computer program changes your phrase to keep your account safe!

Exercises

Exercise 1: Phrase Changing

Write a CICS CHANGE PHRASE command to change a user phrase.

cobol
1
2
3
4
5
6
EXEC CICS CHANGE PHRASE
    USERID(WS-USER-ID)
    PHRASE(WS-NEW-PHRASE)
    RESP(WS-RESPONSE)
    RESP2(WS-RESPONSE2)
END-EXEC.

Exercise 2: Phrase Processing

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

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

Quiz

Question 1

What is the primary purpose of CICS CHANGE PHRASE?

Answer: B) To change a user phrase

Question 2

Which parameter specifies the user ID to change phrase for?

Answer: A) USERID

Related Concepts

CICS Phrase Processing

Phrase processing and output in CICS

CICS User Management

User management and user interaction in CICS

CICS Output Processing

Output processing and phrase display in CICS