In this program you create batch job streams and interactive job streams. A batch job stream can, for example, be a night job, executing the Print invoice and Print invoice journal programs. An interactive job stream could be used to control which company the user will automatically be signed on to.
- Program
- Enter a valid batch program name or a job stream name from the Batch program table.
The *SETUP program is a predefined interactive job stream which is used to control what will happen when a user signs on to the system. You can, for example, define which company the user will automatically be signed on to. There might also be other interactive job streams defined in the system, called *SETUPxx, where xx is the company code. Those job streams can be used to define what will happen after the user selects a company to work with. You could, for example, define which library should be placed first on the library list, that the mailbox should be displayed directly when the user signs on to the system, etc.
- User
- If you enter a valid user from the Work with IBS user profiles file, the batch program, or the job stream, can only be executed by that user. If you enter *ALL, all users in the system are allowed to execute the batch program or job stream.
Copy from
In the fields below you enter information concerning the batch program, or job stream, from which you wish to copy information.
- Program
- Enter the batch program, or job stream, from which you want to copy information. Leave the field blank if you do not want to copy information from another batch program or job stream.
- User
- If the batch program, or job stream, from which you want to copy information is defined for a specific user, enter the user’s name here. Leave the field blank if you do not want to copy information from another batch program or job stream.
Work with job controls (ASGD0292)
On this panel you define what the batch program, or job stream, will do. When you first reach this panel it is empty. You can add, change or delete lines. Scroll to view all established lines.
Function keys
| Shift info | Display the next 30 positions in the parameter string. The function key is useful when you have entered many characters in the parameter string and cannot see the whole string. |
| Resequence line number | Resequence the line numbers within each sequence. If you entered line numbers 5, 6, 7, etc., those will be renamed to 10, 20, 30, etc. |
| Add job schedule entry | Define when the program is to be executed. |
Selection fields
- Program
- Displays the name of the batch program, or job stream, you are maintaining.
- Batch type
- Displays the code for the program you are maintaining. 1 means batch program, 2 means batch job stream and 3 means interactive job stream. All standard IBS Enterprise batch programs are defined as 1.
- User
- Displays the name of the user allowed to execute the batch program or job stream. If *ALL is displayed, it means that all users in the system are allowed to execute the batch program or job stream.
Work with job controls (ASGD0294)
On this panel you define what should be executed in the batch program or job stream, which means you define the statements in the program. You must enter a keyword and parameters for each line. What parameters to enter depends on the keyword.
Function keys
| Execute command | Execute the command entered in the Parameter field. |
| IBS command list | Retrieve a list with all valid IBS Enterprise commands. |
| Work with parameters | Access the Work with parameters panel, where you can retrieve Save Parameter definitions and get help with entering parameters for an IBS Enterprise command. From this panel you can also start the Save Parameter function. |
- Program
- Displays the name of the batch program, or job stream, you are maintaining.
- Batch type
- Displays the code for the program you are maintaining. 1 means batch program, 2 means batch job stream and 3 means interactive job stream. All standard IBS Enterprise batch programs are defined as 1.
- User
- Displays the name of the user allowed to execute the batch program or job stream. If *ALL is displayed, it means that all users in the system are allowed to execute the batch program or job stream.
- Keyword
- Enter the keyword. There are three different types of keywords:
Submit keywords:
DSPSBMJOB, HOLD, INQMSGRPY, JOB, JOBD, JOBPTY, JOBQ, LOG, LOGCLPGM, MSGQ, OUTPTY, OUTQ, PRTDEV, PRTTXT, SWS, USERCommand execution keywords:
EXCCMD, EXCBSBM, EXCCASBM, EXCBPGM, EXCAPGMSpecial keywords:
SECURED, AUTUSR, EXCJOB, EXCBPGMG, EXCAPGMG, DFTCOMP, INLMENU, INLLIBL, FREEPAR1-5The batch type for the program (displayed in the heading of this panel) controls which keywords are allowed. For each batch type, different keywords are allowed.
- Line number
- This field is optional, but if you want to insert a line between two existing lines, enter a line number.
- Parameter
- Enter the parameters for the keyword. The keyword controls which parameters to enter. If you entered a Command execution keyword in the Keyword field, and you enter an OS/400 command in this field, you can prompt to request assistance with entering the parameters for the command.
If you want to enter comments in the batch program or job stream, start with /*, write the text and complete the text with */.
- Copy to
- The fields below are used when you want to copy information from the line you are maintaining, to another line.
- Keyword
- Enter the keyword to which you want to copy the parameters you entered in the Parameter field.
- Line number
- This field is optional, but if you want to copy the information to a certain line, enter the line number here.
Work with parameters (ASGD0295)
From this panel you can retrieve Save Parameters previously saved in a batch program, start the Save Parameter function, and display the window containing parameter definitions available for changes.
The Save Parameter function is a program you activate when you want to save the local data area for an IBS Enterprise batch program. The program name is ASGC037 and the program could also be connected to any of the function keys F13 – F23 in order to activate the Save Parameter function from an IBS Enterprise application program.
Function keys
| Saved parameters list | Display the window containing all Save Parameter definitions created for the program entered in the Program field. |
| Parameter definition list | Display the window containing the Parameter definitions available for the program entered in the Program field. |
| Save parameter | Start the Save Parameter function for the program you entered in the Program field. The initial panel for the program will then be displayed and you can complete the fields on the panel as usual. When you click OK on the last panel, the Save parameter panel will be displayed. When you complete that panel, you will return to this panel and you can click Saved parameters list to retrieve the Save parameter definition you just created. |
- Entry parameter
- Displays the entry parameters in the program, if any. In the IBS Enterprise application there is only one program with entry parameters at the moment; the Backup program (ASGC032). Displays the entry parameters in the program, if any. If you enter ASGC032 in the Program field and click Parameter definition list to retrieve the parameters for that program, the windows with the parameter definitions will be displayed. If you then select one of the parameters in the window, the parameter string will be transferred to the Parameter field on this panel, displayed as:
EXCASWPGM PGM(ASGC032) PARM(Y) DTA(‘&& &&& ‘)In addition, all parameter definitions for the program will be displayed in the middle section on the panel, together with the parameter length, displayed as:
Entry parameter Length Back up Y/N 1 Device 10 Reorganise files Y/N 1 Create save file Y/N 1 Start time 6 Now you can complete the DTA key value with all parameters. The “&” character corresponds to the first position in the parameter length. To complete the parameters with the following values:
Entry parameter Entry Back up Y Device TAP01 Reorganise files N Create save file N Start time 01:00:00 complete the parameter string as follows:
EXCASWPGM PGM(ASGC032) PARM(Y) DTA(‘YTAP01 NN01000 0′)
- Len
- Displays the length of the entry parameters in the program, if any. In the IBS Enterprise application there is only one program with entry parameters at the moment; the Backup program (ASGC032). Refer to the Panel help for the Entry parameter field above.
- Program
- Enter the program name for which you want to retrieve the Save Parameter list (click Saved parameters list), display the parameter definition list or start the Save Parameter function.
- User
- This field is mandatory if you want to retrieve a Save Parameter list (click Saved parameters list). The system keeps track of the user activating the Save Parameter function, which means that the window retrieved when you click that function key only contains Save Parameters created by the user entered in this field.
- Parameter
- When you press one of the available function keys and select a record in the window displayed for that function key, the system automatically retrieves all parameters for that function key. When the parameters are retrieved, click OK once again to transfer the parameters to the previous panel.