Input JCL Statements
The following are the input data sets:
ca712
The following are the input data sets:
- SASSX2U2 DBPARM DD Statement
- Specifies theCA 7database from which to extract data.
- SASSX2U2 X2U2NODE Statement
- This file contains Node-Agent relationship information. Every XPJOB that currently runs at NODExwill run at AGENTyafter the conversion is complete. You should already have defined agents as part of theBroadcomIntegrated Agent Services (IAS) installation. Your job is to identify the Node-Agent associations and place them in this file. Code as many as you need. This file is a comma-delimited file containing the following fields:
- NODE (1-8 characters - required)
- AGENT (1-16 characters - required)
- JOBTYPE (6-8 character, constants below - required)
- NT_JOB for Windows
- UNIX_JOB for UNIX
- JCLLIB (JCL Library that appears in the /DISPLAY,ST=JCLVAR output - optional)
During XPJOB definition (DB.10 screen), the node where the job would run was entered in the XP Node field. So, every XPJOB has an associated Node which can be up to eight characters in length. This information is what is placed in the NODE position.
Assume that all XPJOBs running at NODE
x
run at AGENTy
when conversion is completed. Thus, AGENTy
is what is placed in the AGENT position.As stated earlier, XPJOBs can be converted to NT_JOBs or UNIX_JOBs. If the NODE where the XPJOB runs is a Windows operating environment, use NT_JOB for the JOBTYPE. If the NODE where the XPJOB runs is a UNIX operating environment, specify UNIX_JOB for the JOBTYPE.
Not all XPJOBs have an Optional PARMLIB. Agent jobs require a PARMLIB. You can specify a JCL library where information required by the agent job is stored. This library is only used in the following cases:
- The XPJOB XP Node information matches a NODE in this table.
- The XPJOB doesnotalready contain an Optional PARMLIB.
The JCL library specified must match a library in the /DISPLAY,ST=JCLVAR output. If you do not specify this field and the XPJOB does not contain an Optional PARMLIB, specify a default PARMLIB in the SYSIN DD (discussed later in this topic); otherwise, the job is not converted.
Examples
NYNODE1,NYAGENT005,UNIX_JOB,highlvl.cai.JCLLIB1 MYWIND,MYAGENT,NT_JOB YOURWIND,YOURAGENT,NT_JOB,highlvl.cai.JCLLIB2
Remember, every unique XP Node (associated to the XPJOB being converted) must have an entry in this file.
- SASSX2U2 X2UTBTII Statement
- This file contains all the LJOB and LJCL output for the XPJOBs requested for conversion. The file is created in the first job step as a temporary file.
- SASSX2U2 SYSIN Statement
- (Optional) The SYSIN data set contains processing keywords used by SASSX2U2. If this statement is not supplied, the following occurs:
- No back out job is created. If you have a problem with the converted job, youcannotrestore it back to its XPJOB state.
- No default PARMLIB is supplied. If the XPJOB being converted does not have an Optional PARMLIB, and one was not specified on the appropriate NODE line in the X2U2NODE file, the XPJOB is not converted.
The three valid keywords are RESTMASK, DEFPRLIB, and INTERACT.
- RESTMASK
- Defines a two-character value that creates the restore name of the XPJOB definition. If a RESTMASK is not provided, a backup of the XPJOB definition is not created. The member being converted has a character in its name replaced by the mask. The first character is the replacement character, and the second character indicates the offset of the replacement character in the member name. For example:
- RESTMASK=$2
- The restore name for member CA7XJOB is C$7XJOB.
- RESTMASK=#3
- The restore name for member CA7XJOB is CA#XJOB.
- If the member name is not as long as the offset position, the mask character is placed in the first blank position of the member name. For example:
- RESTMASK=$4
- The restore name for member CA7X is CA7$.
- The restore name for member CA7Y is also CA7$.
- If the mask character becomes the last character of the member name, you could end up with duplicate member names and could get unwanted results during conversion. In the preceding situation, CA7Y would not convert. However, its JCL would be deleted. This situation is discussed in greater detail under SASSX2U2 X2U2CONV DD.
- The last RESTMASK value specified in the SYSIN DD statement is the value used when creating the restore name.
- Before conversion, verify that yourCA 7database has enough space to hold backup copies of the XPJOBs being converted.
- DEFPRLIB
- Identifies the default PARMLIB data set used to hold required AGJOB information. Remember, XPJOBs may or may not have an Optional PARMLIB specified whereas AGJOBs require a PARMLIB. The hierarchy of placement is as follows:
- If the XPJOB definition has an Optional PARMLIB/MEMBER specified, the AGJOB information replaces the XPJOB information in this library.
- If the XPJOB definition has no Optional PARMLIB/MEMBER, AGJOB information is placed in the JCLLIB specified in the X2U2NODE DD statement for the NODE where the XPJOB executes.
- If no JCLLIB is specified in the X2U2NODE DD statement for the NODE where the XPJOB executes, AGJOB information is placed in the DEFPRLIB library.
- If a DEFPRLIB is not specified, the job is not converted (assuming the conditions described in Items 1 and 2 are not met).This parameter has the following syntax:DEFPRLIB=highlvl.CAI.JCLLIBThis library must be found in the /DISPLAY,ST=JCLVAR output. If not, a WTO is issued, and the job terminates.
- INTERACT=NO|YES
- Identifies whether the AGJOB runs in foreground or background on the Windows operating environment (not valid with UNIX_JOBs). Valid values are YES and NO. NO is the default. If something other than YES or NO is specified, NO is used. As a simple example, consider an AGJOB that invokes the Windows Calculator. If you execute C:\WINDOWS\SYSTEM32\CALC.EXE without the INTERACT parameter, you do not see the calculator on your monitor. If you execute with the INTERACT parameter set to YES, you see the calculator on your monitor.