Contents
Chapter 1. Introduction to Sterling
Connect:Direct commands.......1
Supported commands ...........1
Writing Sterling Connect:Direct commands ....2
Native format .............2
Command example ...........3
Command syntax ............3
Indicating case sensitivity .........6
Indicating selection criteria ........7
Indicating output destination ........7
Chapter 2. The batch interface .....9
Batch interface job requirements ........9
Processing rules ............9
Sample job stream to run the batch interface . . . 10
DDNAMES for DGADBATC........10
DGADBATC EXEC parameters .......11
DGADBATC return codes with DGADCHLA . . 11
Using the MAXDELAY keyword parameter to
synchronize submitted Processes .......12
Chapter 3. The Interactive User
Interface (IUI) ............15
Primary Options Menu ..........15
Navigating the Interactive User Interface . . . 17
Using the PF Keys ...........18
Displaying Your User Authorization .....18
Getting Help .............19
Operator Tables .............19
Messages ...............20
Message Example ...........21
Messages in a Sterling Connect:Direct/Plex
Environment .............22
Viewing and Printing Messages Using Different
Criteria ...............22
Viewing a Message List .........23
Printing Messages ...........24
Chapter 4. The Application Program
Interface ..............25
DGADCHLA Program...........25
Required Parameters for DGADCHLA ....26
Extracting Return Codes .........27
UICB Fields .............29
DGADCHLA Return Codes ........32
DGADCHLA Examples ..........32
Sample Job Stream for Executing the Program . . . 34
Chapter 5. Managing Sessions ....37
Signing On to Sterling Connect:Direct for z/OS . . 37
Timeout Problems ...........37
Using SIGNON through the IUI ......38
SIGNON Command ..........40
Signing On to the API ..........45
Signing On to Multiple Sessions ......46
Swap Node Command ..........48
Using SWAP NODE through the IUI .....48
Using SWAP NODE through the Batch Interface 49
Sign Off Command ............49
Using SIGNOFF Through the IUI ......49
Using SIGNOFF through the Batch Interface . . 50
Sequencing the SIGNON, SWAP NODE, and
SIGNOFF Commands ...........50
Chapter 6. Building, Modifying, and
Submitting Processes ........53
Process Routing .............54
Process Queuing.............54
Process Selection ...........55
Intelligent Session Retry .........55
Process Execution Example ........56
Process Management in a Sterling
Connect:Direct/Plex ..........60
SUBMIT Command............62
SUBMIT Command Examples .......70
Submitting Processes through the Batch Interface 71
Submitting Processes through the IUI......71
IUI Submit Options...........71
Validating Processes from the SB, DF, and CF IUI
Options ...............72
Using the SB IUI Option to Submit a Predefined
Process ................72
Using the DF IUI Option to Create, Edit, and
Submit Processes ............74
Modifying and Submitting a Process Using the
DF IUI Option ............75
Creating and Submitting a New Process Using
the DF IUI Option ...........75
Submitting a Process Using the DF IUI Option . 76
Using Statement Models to Create a Process . . 76
Using the CF IUI Option to Generate a COPY
Process ................77
Generating a COPY Process ........78
Chapter 7. Controlling Processes in the
TCQ................83
Controlling Processes with Commands .....83
Setting Selection Criteria .........83
Modifying a Process in the TCQ with CHANGE
PROCESS ...............83
CHANGE PROCESS Command Format ....83
CHANGE PROCESS Command Examples . . . 88
Issuing CHANGE PROCESS through the Batch
Interface ..............88
Issuing CHANGE PROCESS through the IUI . . 89
Suspending, Flushing, and Deleting Processes . . . 89
SUSPEND, FLUSH, or DELETE PROCESS
Command Format ...........90
© Copyright IBM Corp. 1999, 2012 iii