USS User Process Initiation via ISPF Interface
To get started, enter the FDR/UPSTREAM TSO/ISPF Interface via your installation defined method. From the main menu specify option number 1, “USTBATCH”, and press ENTER.
Initiate USS User Process via ISPF - Selecting the USTBATCH Option
COMMAND ===> 1
1 USTBATCH - Host Initiated Services
2 STATUS - Current Status Information
3 DEFINE - Define Control Files
4 CONFIGURE - Main Options
5 PROFILE - Workstation Profile Names
6 OPER - Operator Commands
7 REPORT - Report
8 REGISTRY - Name Registry
9 DUPAUDIT - Duplicate File Audit
10 SCHEDULE - Command Scheduler
11 MANAGEMENT - Backup Management
12 FDRCRYPT - FDRCRYPT Options
On the next menu to appear, select Action # 3, “RUN A PC JOB”. All other fields should have been pre-filled in from previous executions of the USTBATCH panels. If you want to override or specify any of the other fields on this menu, feel free to do so at this point. These other fields are described in detail in the table below. When you are finished, press the ENTER key.
Menu Field | Description |
APPLPREF | The 5 character prefix of the VTAM APPLID to be used by USTBATCH for its communications with the FDR/UPSTREAM MVS Started Task. |
USAPPL | The VTAM APPLID of the FDR/UPSTREAM Started Task. |
TPNAME | The Transaction Program Name to be used during LU 6.2 communications. |
LOGMODE | The VTAM LOGMODE to be used for communicating with the FDR/UPSTREAM Started Task. |
CONV | Whether or not the USTBATCH requesting JOB should wait for the completion of the request submitted to the Started Task or end immediately after the request is accepted. |
WTOCOMP | Should a WTO Completion message be issued to the MVS system operator when this request finishes. |
TCP/IP ADDR | The IP address of the z/OS system running the USS files you wish to backup. |
PORT | The TCP port number configured in the FDR/UPSTREAM USS process or daemon that it will receive requests on. 2972 is the default for the USS process but not for USTBATCH so it must be specifically coded here. |
ACTION | Which function is to be performed by this set of generated statements. |
Initiate USS User Process via ISPF - Specifying the USTBATCH Parameters
COMMAND ===>
GEN - Generate statements READ/SAVE/DELETE parameter set
APPLPREF ===> UPSTR | QUEUE ===> | MAXRETRY ===>
USAPPL ===> UPSTREAM | CONV ===> WAIT | TMAXRETRY ===>
TPNAME ===> UPSTREAM | WTOCOMP ===> YES | APPLRETRY ===>
LOGMODE ===> #INTER | RESTART ===> (count,minutes)
TARGNAME ===> or TARGLU ===>
or DNSname ===>
or TCP/IP addr ===> 192.168.75.45 TCP/IP port ===> 2972
WSPARM ===>
USERID ===> | PASSWORD ===>
ACTION ===> 3 (specify to display related parameters and press enter)
1 - Backup 5 - Restart Backup 9 - FDRSOS Backup
2 - Restore & Inquiry 6 - Restart Restore 10 - FDRSOS Restore
3 - Run a PC Job 7 - Kill Restart Backup 11 - PC Migration
4 - File Transfer 8 - Kill Restart Restore 12 - Operator Commands
The next menu to appear allows for the specification of the actual file in the USS file system, to be executed. You can specify an executable file, script file, or other file system entity. You specify this value via the “Command Line” field. If you would like to control the retrn code mapping returned to the originating USTBATCH JOB, you can customize the “Return Code Map” field.
Enter the command you want executed and press the ENTER key. Then press the PF3 key to return to the prior menu.
Initiate USS User Process via ISPF - Specifying the Process and Options
COMMAND ===> SCROLL ===> PAGE
More: +
---Optional ULTra Workstation Options----- --LAN Interface-----
| | | |
| LAN WS Name...( )| | ( X ) IPX/SPX |
| | | ( ) NetBIOS |
| LAN WS Pwd....( ) | | ( ) TCP/IP |
| | | |
------------------------------------------ --------------------
Command Line....( )
Return Code Map ( 0:0 ?:8 )
-------------------------------------------------------------------------------
| ( ) Do not run job, terminate UPSTREAM or ULTra immediately |
| |
| ( X ) Run job from UPSTREAM or ULTra and: |
| |
| |
| < > Wait for job completion |
| |
| < > Terminate UPSTREAM or ULTra after job start/completion |
| |
| < > Log STDOUT and STDERR |
| |
| < > Kill job after wait time limit |
| |
| Wait Time Limit: ( ) Milliseconds |
|------------------------------------------------------------------------------
OK <enter> Prior panel <PF3>
At this menu, enter the GEN command on the COMMAND line at the top of the menu. This will generate the USTBATCH statements and JCL necessary to submit an MVS batch JOB to execute your command.
Initiate USS User Process via ISPF - Generating the USTBATCH Parameters
COMMAND ===> GEN
GEN - Generate statements READ/SAVE/DELETE parameter set
APPLPREF ===> UPSTR | QUEUE ===> | MAXRETRY ===>
USAPPL ===> UPSTREAM | CONV ===> WAIT | TMAXRETRY ===>
TPNAME ===> UPSTREAM | WTOCOMP ===> YES | APPLRETRY ===>
LOGMODE ===> #INTER | RESTART ===> (count,minutes)
TARGNAME ===> or TARGLU ===>
or DNSname ===>
or TCP/IP addr ===> 192.168.75.45 TCP/IP port ===> 2972
WSPARM ===>
USERID ===> | PASSWORD ===>
ACTION ===> 3 (specify to display related parameters and press enter)
1 - Backup 5 - Restart Backup 9 - FDRSOS Backup
2 - Restore & Inquiry 6 - Restart Restore 10 - FDRSOS Restore
3 - Run a PC Job 7 - Kill Restart Backup 11 - PC Migration
4 - File Transfer 8 - Kill Restart Restore 12 - Operator Commands
On this menu, you may modify the JCL to be generated along with your USTBATCH control statements. You may want to pay particular attention to make sure that the JOB card and STEPLIB conform to installation standards and reflect the appropriate values.
Select the number “2” on the COMMAND line at the top of the menu and press the ENTER key to proceed into an ISPF EDIT session.
Initiate USS User Process via ISPF - Altering the USTBATCH JCL
COMMAND ===> 2
Please select one of the following options or press the END key to cancel
1 - Browse the generated JCL stream
2 - Edit the generated JCL stream
3 - Submit the generated JCL stream
4 - Save the generated JCL in a data set
5 - Run the generated USTBATCH statements in the TSO foreground
JCL statements:
( //jobname JOB (job acct data),'job id data',NOTIFY=userid )
( //* )
( //* )
( //* )
( //USTBATCH EXEC PGM=USTBATCH )
( //STEPLIB DD DISP=SHR,DSN=your.upstream.load.library )
( //SYSUDUMP DD SYSOUT=* )
( //USTLOG DD SYSOUT=*
Menu Field | Description |
COMMAND | Select “2” in order to edit the generated USTBATCH JCL and parameters. |
JOB Card Information | This field must specify a valid z/OS JOB Card in order for the JCL generation to work properly. Please specify all applicable information that is applicable to your installation standards. |
STEPLIB DD DSN | This field is the dataset name of the FDR/UPSTREAM MVS LOADLIB. This library must have been previously APF authorized. This DD statement is not required if the LOADLIB has been placed in the z/OS LINKLST concatenation. |
From this menu, this is a normal ISPF EDIT session, you may alter or save the generated control statements for use. You may also submit the JCL for MVS processing without saving.
Initiate USS User Process via ISPF - Viewing the USTBATCH Parameters
‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹‹
EDIT------ USER01.SPFTEMP1.CNTL---------------------------- Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
000001 //jobname JOB (accounting,information),'job id data',
000002 // NOTIFY=userid
000003 //*
000004 //*
000005 //BACKUP EXEC PGM=USTBATCH
000006 //STEPLIB DD DISP=SHR,DSN= your.upstream.load.library
000007 //SYSUDUMP DD SYSOUT=*
000008 //USTLOG DD SYSOUT=*
000009 //USTPARM DD *
000010 APPLPREF=UPSTR
000011 USAPPL=UPSTREAM
000012 LOGMODE=#INTER
000013 CONV=WAIT
000014 *
000015 TCPTARG=192.168.75.249..2972
000016 *
000017 ACTION=5
000017 SPECNUMBER=1
000018 FILES=/u/user01/setupdb
000019 *
000020 ENDPARM
000021 /*
000022 //