MultiChange Script Processor (VTAM)
The MultiChange Script Processor helps prepare scripts for playback. It allows you to change scripts to reflect application changes without re-creating those scripts. This script processor creates and maintains these modification requests and runs them in background or foreground mode.
To use the MultiChange Script Processor, select option 5 MultiChange Processor on the Script Processors menu and press Enter.
Script Processors Menu. ----------------------------- Script Processors ------------------------------- .
. Option ===> .
. .
. .
. 1 REXX Processor Create "Smart" Script(s) .
. 2 Date Change Change Year Formats for Date Testing .
. 3 Date Find Report Location(s) of Date Field(s) .
. 4 Input Field Formats Change Input Fields to Row/Column Format .
. 5 MultiChange Processor Update Scripts to Reflect Application Changes .
. 6 Security Script Processor Locate and Modify Passwords .
. 7 Euro Euro Script Utility .
. 8 GST GST Testing Utility .
. 9 Message Filtering Message Filtering Utility .The following screen appears:
MultiChange Script Facility Primary Options screen. ----------------- Multichange Script Facility Primary Options ----------------- .
. Option ===> .
. .
. 1 Maintain Input Fields Values 3 Add Script .
. 2 Modify Output Screen 4 Erase Interaction .
. Go Process Requests .
. .
. Specify the name of the control file below, then press Enter key .
. .
. Project . . . .
. Group . . . . .
. Type . . . . .
. Member. . . . .
. .
. Other Data Set Name: .
. Data Set Name . . . .
. .- Enter the name of the script processor control file.
The MultiChange Script Processor stores user-entered information in the control file. For example, in order for the MultiChange Script Processor to change input field values recorded in a script, an appropriate Maintain Input Field Value entry must be created and will be saved in the control file.
The control file can be a PDS member or a sequential file. Although there are no specific requirements for the record length and record format of the control file, a fixed block record format and a record length of 80 bytes is recommended. - Select one of the following options:
- 1. Maintain Input Fields Values: Use this function to add, replace, delete and move input field values recorded in the script. See Maintain Input Field Values.
- 2. Modify Output Screen: Use this function to add new input/output fields, delete existing input/output fields, and change screen constants. See Modify Output Screen.
- 3. Add Script: Use this function to insert a script at existing locations within another script. See Add Script.
- 4. Erase Interaction: An Interaction is an output from the domain destination (business system or application) and the subsequent input from the user. Use this function to remove specific interactions from a script (for example, a signon screen and the subsequent user ID and password). See Erase Interaction.
- Type GO on the Option line and press Enter to begin execution. See Executing MultiChange Script Processor Requests.
Maintain Input Field Values
Select option 1 Maintain Input Fields Values on the MultiChange Script Facility Primary Options screen. The following screen appears:
Maintain Input Field Values Item List screen. -------------------- MAINTAIN INPUT FIELD VALUE ITEM LIST ------------------- .
. Option ===> Scroll ===> PAGE .
. .
. ADD Create New Items .
. .
. Line Cmds: U Update D Delete B Browse .
. .
. .
. SCREENID LOCATION OPERATION INPUT-VALUE TO-VALUE .
. ------------------------------------------------------------------------------- .
. ** NONE ** .
. ******************************* BOTTOM OF DATA ******************************** .If the control file already contains Maintain Input Field Value items, they appear on the screen. If no entries exist, the message ** none ** appears.
Enter the ADD primary command to create a new item or use one of the line commands to (U)pdate, (D)elete, or (B)rowse an item. The ADD command displays the following screen:
Maintain Input Field Request Types screen. ---------------------- Maintain Input Field Request Types --------------------- .
. Command===> .
. .
. Select one of the options below and press ENTER: .
. .
. 1 Add Input field value .
. 2 Replace Input field value .
. 3 Delete Input field value .
. 4 Move Input field value .Select one of the following options based on the type of operation to be performed on the script:
- 1. Add Input Field Value: Requests the insertion of an input field within an input group.
- 2. Replace Input Field Value: Requests the change to values of existing input within a script.
- 3. Delete Input Field Value: Requests the removal of an input from a script.
- 4. Move Input Field Value: Requests the repositioning of input fields within an input group.
The field-level operations are used to operate on specific inputs within a script. The fields on all four screens are the same.
When you request a field-level operation (add, replace, delete, or move, the corresponding Input Field Value Item screen appears.
Add Input Field Value Item screen. ------------------- ADD Add Input Field Value Item ------------------ .
. Command ===> .
. .
. END End with save .
. Cancel End without save .
. Enter Add Entry .
. .
. .
. Enter the Screen ID whose input will be modified: .
. Screen ID . . . . . Row,Column , .
. Enter the input value and location: .
. Input Value . . . . Input Number .
. Row,Column , .
. Enter the modified value: .
. Change To . . . . . To Input Number .
. Row,Column , .
. All input designations (row,column or number) must be consistent .
. for all requests (i.e. if one request specifies input number .
. all must). .- Enter the Screen ID of the output screen that contains the field to be manipulated. The value is case sensitive.
- Enter the Row,Column location of the screen ID on the output screen. Be sure that the row and column values specify the exact location on the application screen, not the script location.
- Enter the Input Value. For an add field request, this is the data contained in or to be added to the input group, which is required. For other requests, this optional entry provides a validating value that the existing value must match before the operation is performed.
Enter either the Input Number or Row,Column.
- Input Number is the location of the input field to be manipulated.
- Row,Column is the physical screen location of the input field to be manipulated.
- Enter the Change To value to which the input will be changed. For a Replace Field request, this is the new data for the input and is a required field. For any other operation, any value in this field is invalid.
Enter the To Input Number or Row,Column when using the Change To field. Input Number is the relative location of the field in the input group where the new value input will be placed. Row,Column is the actual location where the change value is placed.
Modify Output screen
Select option 2 Modify Output Screen on the MultiChange Script Facility Primary Options screen to display the following screen:
Modify Output Screen Item List. -------------------- -- MODIFY OUTPUT SCREEN ITEM LIST -- ------------------- .
. Option ===> Scroll ===> PAGE .
. .
. ADD Create New Items .
. .
. Line Cmds: U Update D Delete B Browse .
. .
. .
. SCREENID LOCATION OPERATION DESCRIPTION .
. ------------------------------------------------------------------------------- .
. ** NONE ** .
. ******************************* BOTTOM OF DATA ******************************** .If the control file already contains Modify Output Screen entries, they are listed on the screen. If no entries exist, ** none ** appears.
Enter the ADD primary command to create a new item or use one of the line commands to (U)pdate, (D)elete, or (B)rowse an item. The ADD command displays the following screen:
Modify Output Screen Item Types screen. ----------------------- Modify Output Screen Item Types ----------------------- .
. Command===> .
. .
. Select of the the following options and press ENTER: .
. .
. 1 Add field to screen .
. 2 Delete field from screen .
. 3 Modify screen constant .- Select one of the following options:
- 1. Add field to screen: This option allows you to put new input or output fields to any specified <OUTPUT> section (output screen) within a recorded script. See Add Field To Screen for details.
- 2. Delete field from screen: This option allows you to remove existing input or output fields from any specified <OUTPUT> section (output screen) within a recorded script. See Delete Field From Screen for details.
- 3. Modify screen constant: This option allows you to modify screen constants appearing anywhere in a specified <OUTPUT> section (output screen) within a recorded script. See Modify Screen Constant for details.
Add Field To Screen
Select option 1 Add field to screen on the Modify Output Screen Item Types screen and press Enter. The following screen appears:
Add Field to Screen Item. ----------------------- ADD Add Field To Screen Item ----------------------- .
. Command ===> .
. .
. END End with save .
. Cancel End without save .
. Enter Add Entry .
. .
. Description. . . .
. .
. Identify the screen to add field: .
. Screen ID. . . * .
. ID location. . 5 , 11 (Row,Col) .
. .
. Describe the field to be added: .
. Field type . . I-Input, O-Output .
. Location . . . , (Row,Col) .
. Length . . . . Maximum 60 Characters .
. Field value. . .
. .
. Describe field attributes (Atr byte occupies 1 position just before the field): .
. Intensity. . . N-Normal, H-High, D-Dark End of Fld Marker? Y/N .
. Numeric? . . . Y/N/blank Auto Skip?. . . . Y/N/blank .
. Set MDT? . . . Y/N Allow Fld Overlap? Y/N .- Enter an optional Description of the add field entry.
- Enter a Screen ID. This is the text that identifies the screen in the recorded script in which the new field will be added. Wildcards are not allowed. They are treated as the actual screen ID.
- Enter an ID Location (row and column location of the Screen ID text). Enter ** in the row and *** in the column field to specify that the screen ID text can appear anywhere on the screen.
- Enter the Field Type for the field being added. Enter I to add an input field and O to add an output field.
- Specify the Location (row and column location on the screen where the new field will be added). Rows must be numbers between 1 and 43 and columns must be numbers between 1 and 132.
Do not include the attribute byte when counting the field location. The attribute byte occupies an additional column position just before the field on the screen. For example, if you enter the field location as 10,20 (10th row and 20th column), then the attribute byte is placed at column 19, followed by the actual field at column 20. - Specify the Length of the new field being added. The length must be numeric and cannot exceed 60 characters. Do not count the attribute byte as part of the length. If you enter the field length as 10, the new field will occupy 11 positions on the screen (one extra position for attribute byte).
- Enter the Field Value. This is the initial value to be placed as field filler when adding output fields. For input fields, binary zeros are always used. Performance Test appends blanks if the value is shorter than the field length.
- Specify the Intensity of the field being added. Enter N for normal intensity, H for high intensity, and D for non-display.
- In the Numeric field, enter Y to enable the keyword numeric feature. Otherwise, enter N. When set to Y, any attempt to enter non-numeric data in this field results in keyboard lock on supported keyboards. Applicable only for input fields — cannot be used for output fields.
- Enter Y to set MDT on or N to set MDT off.
- Specify an End of Fld Marker. The End-of-field marker is a one-byte attribute byte that marks the end of the field being added. It is placed just after the field and occupies an additional position on the screen.
- Y specifies that an end-of-field marker is required.
- N specifies that an end-of-field marker is not required. In this case, the new field attribute continues (even beyond the field length) until another attribute character is encountered.
Specify whether you want to use Autoskip. Enter Y to enable. This causes the cursor to jump to the next input field on the screen automatically when data is entered in the last field position. Autoskip is applicable only for input fields; it cannot be used for output fields.
Specify whether to Allow Fld Overlap. This specifies whether to process or reject the request during execution if the new field overlays any existing attribute bytes/input fields on the screen.
- Y adds the field to the screen no matter what the screen area contains. In this case, any attribute bytes lost (buried) during the process are ignored. No attempt is made to adjust the extended attribute buckets (when processing scripts containing extended attribute bytes).
- N adds the field only if the following conditions are satisfied:
- The screen area where the new field will be placed is free of attribute bytes.
- The new field does not overlay any other existing input field on the same screen row.
- Press Enter to add the entry without exiting the Add Field to Screen Item field. After all entries have been added, press END to save new entries into the control file or use CANCEL to exit without saving the entries.
Delete Field From Screen
Select option 2 Delete field from screen on the Modify Output Screen Item Types screen and press Enter. The following screen appears:
Delete Field From Screen Item. --------------------- ADD Delete Field From Screen Item -------------------- .
. Command ===> .
. .
. END End with save .
. Cancel End without save .
. Enter Add Item .
. .
. Enter optional description: .
. Description . . . . .
. .
. Identify the screen to delete field: .
. Screen ID. . . . . . * .
. ID location. . . . . 5 , 11 (Row,Col) .
. .
. Describe the field to be deleted: .
. Location . . . . . . , (Row,Col) .
. Length . . . . . . . .
. Field filler data. . .
. Field Stopper? . . . Y Yes, N No .
. Overlay ATR bytes? . Y Yes, N No .- Enter an optional Description of the delete field entry.
- Enter a Screen ID. This is the text that identifies the screen in the recorded script from which the field will be modified. This field is case sensitive — the uppercase and lowercase characters must match the screen ID in the script exactly. Wildcards are not allowed. The wildcard character is treated as the actual screen ID.
- Enter an ID Location (row and column location of the Screen ID text). Enter ** in the row field and *** in the column field to specify that the screen ID text can appear anywhere on the screen.
Specify the Location (row and column location of the field to be deleted from the screen). Rows must be numbers between 1 and 43 and columns must be numbers between 1 and 132.
Do not include the attribute byte when counting the field location. If your field attribute starts at column 19, and is followed by the actual field, you must enter the column number as 20.- Specify the Length of the field being deleted. Field length must be numeric and cannot exceed 60 characters. Do not count the attribute byte as part of the length.
- Enter the Field Filler Data. This is the data value to be used to fill the field area on the screen after the field is removed. The default value is binary zeros. If the value is shorter than the field length, Performance Test appends blanks.
- Specify whether to delete any Field Stopper? field (if any) found at the end of the field being deleted. Enter Y or N.
Specify whether to overlay attribute types (Overlay ATR bytes?) regardless of the field contents. Enter Y to continue delete operation or N to reject the delete request if attribute bytes are found within the screen area specified.
- Press Enter to add the entry without exiting the Delete Field from Screen Item screen. After all entries have been added, press END to save new entries into the control file or use CANCEL to exit without saving the entries.
Modify Screen Constant
Select option 3 Modify screen constant on the Modify Output Screen Item Types screen and press Enter to display the following screen:
Modify Screen Constant Item. ---------------------- ADD Modify Screen Constant Item --------------------- .
. Command ===> .
. .
. END End with save .
. Cancel End without Save .
. Enter Add Item .
. .
. Enter optional description: .
. Description. . . . . . .
. .
. Identify the screen where the constant is located: .
. Screen ID. . . . . . . * .
. ID Location. . . . . . 5 , 11 (Row,Col) .
. .
. Describe Constant to be modified: .
. Constant Location. . . , (Row,Col) .
. Constant Length. . . . .
. Change FROM Value. . . (Optional) .
. Change TO Value. . . . .- Enter an optional Description of the modify field entry.
- Enter a Screen ID. This is the text that identifies the screen in the recorded script from which the field will be modified. Wildcards are not allowed. The wildcard character is treated as the actual screen ID.
- Enter an ID Location (row and column location of the Screen ID text). Enter ** in the row field and *** in the column field to specify that the screen ID text can appear anywhere on the screen.
- Specify the Constant Location (row and column location on the screen area where the constant starts). Row numbers must be between 1 and 43 and column numbers must be between 1 and 132.
- Enter a Constant Length (the length of the constant being modified). The constant length must be numeric and cannot exceed 60 characters.
- Specify the Change From Value. If you leave this field blank, any data found in that location is replaced with the new value. The length of this field cannot exceed the Constant Length value. If the length of this field is shorter than the Constant Length value, Performance Test appends blanks.
Specify the Change To Value (the new value to replace the screen area). The length of this field cannot exceed the Constant Length value. If the length of this field is shorter than the Constant Length value, Performance Test appends blanks.
- Press Enter to add the entry without exiting the Modify Screen Constant Item screen. After all entries have been added, press END to save new entries into the control file or use CANCEL to exit without saving the entries.
Add Script
Select option 3 Add Script on the MultiChange Script Facility Primary Options screen to display the following screen:
Add Script Item List screen. -------------------- ------- ADD SCRIPT ITEM LIST ------- ------------------- .
. Option ===> Scroll ===> PAGE .
. .
. ADD Create New Items .
. .
. Line Cmds: U Update D Delete B Browse .
. .
. .
. SCREENID LOCATION OPERATION SCRIPT NAME .
. ------------------------------------------------------------------------------- .
. ** NONE ** .
. ******************************* BOTTOM OF DATA ******************************** .The Add Script request inserts a script at existing locations within another script.
Enter the ADD primary command to create a new item or use one of the line commands to (U)pdate, (D)elete, or (B)rowse an item. The ADD command displays the following screen:
Add Script Item screen. ---------------------------- ADD Add Script Item --------------------------- .
. Command ===> .
. .
. END End with save .
. CANcel End without save .
. Enter Add Entry .
. .
. Enter the Screen ID and location (the script will be inserted .
. after this screen): .
. Screen ID . . . . . * Row,Column 5 , 11 .
. .
. Enter the script to be added: .
. Add Script. . . . . .- Enter a Screen ID. This field specifies a screen after which the script will be inserted. This field is case sensitive — the uppercase and lowercase characters must match the screen ID in the script exactly. Wildcards are not allowed. The wildcard character is treated as the actual screen ID.
- Enter the location (Row,Column) of the screen ID on the output screen. The Screen ID and Row,Column entries identify the screen where the input values will be manipulated. For example, you might wish to add a script following the Order Entry screen. Screen ID and Row,Column would be used to identify the Order Entry screen.
- In the Add Script field, specify the data set and script name to be inserted.
- Press Enter to add the entry without exiting the Add Script Item screen. After all entries have been added, use END to exit the Add Script Item screen and save the new entries in the control file or use CANCEL to exit without saving the entries.
Erase Interaction
An interaction is an output from the TPF and the subsequent input from the user. Use the erase interaction request to remove specific interactions from a script (for example, a signon screen and the subsequent user ID and password).
Select option 4 Erase Interaction on the MultiChange Script Facility Primary Options screen to display the following screen:
Erase Interaction screen. -------------------- --------- ERASE INTERACTION -------- ------------------- .
. Option ===> Scroll ===> PAGE .
. .
. ADD Create New Items .
. .
. Line Cmds: U Update D Delete B Browse .
. .
. .
. SCREENID LOCATION OPERATION DATAID DATAID-LOC .
. ------------------------------------------------------------------------------- .
. ** NONE ** .
. ******************************* BOTTOM OF DATA ******************************** .Enter the ADD primary command to create a new item or use one of the line commands to (U)pdate, (D)elete, or (B)rowse an item. The ADD command displays the Erase Interaction Request: ADD/Update screen.
Erase Interaction Request: ADD/UPDATE screen. -------------------- Erase Interaction Request: ADD/UPDATE -------------------- .
. Command ===> .
. .
. END End with save .
. CANcel End Without save .
. Enter Add Entry .
. .
. Enter the Screen ID and location (optional): .
. Screen ID . . . . . * Row,Column. . . 5 , 11 .
. .
. Enter the Data ID and location (required): .
. Data ID. . . . . . Row,Column. . . , .
. Insert a PAUSE statement? Erase OUTPUT only? .
. Pause?. . . . . . . N Output Only?. . N .- Enter a Screen ID for the screen for which you want to create an erase interaction request. This field is case sensitive — the uppercase and lowercase characters must match the screen ID in the script exactly. Wildcards are not allowed. The wildcard character is treated as the actual screen ID.
Enter the position (Row,Column) of the Screen ID on the output screen.
- Enter the Data ID (data that further identifies the output screen).
Enter the position (Row,Column) of the data on the output screen.
- Specify whether to insert a Pause statement. Enter Y to replace the interaction being removed with a <PAUSE> statement.
- Specify whether to erase Output Only. Enter Y only if you want to remove the output screens.
Executing MultiChange Script Processor requests
Enter GO from the MultiChange Script Facility Primary Options screen. The initial Script Processor * MultiChange Execution screen appears.
Initial Script Processor MultiChange Execution screen. ------------------- Script Processor * MultiChange Execution ------------------ .
. Command ===> .
. .
. Enter to continue .
. .
. Specify the dataset which contains the scripts: .
. Project . . . .
. Group . . . . .
. Type . . . . .
. .
. Other Data Set Name: .
. Data Set Name . . . 'PMIJSS0.HIPER.VTAM.SCRIPTS' .
. .
. Specify the dataset to which the modified scripts will be written: .
. Project . . . .
. Group . . . . .
. Type . . . . .
. .
. Other Data Set Name: .
. Data Set Name . . . 'PMIJSS0.HIPER.VTAM.SCRIPTS.OUTPUT' .Enter only the file names on this screen, not the script/member names. The input and output data sets can be the same file or different files.
- Enter the name of the data set containing the existing scripts (Project, Group, Type). Use Other Dataset Name if your data set name does not follow standard ISPF naming conventions. This input data set must exist.
- Enter the name of the data set to which the modified scripts will be written (Project, Group, Type). Use Other Dataset Name if your data set name does not follow standard ISPF naming conventions. If this output data set does not exist, an allocation screen will appear when you press Enter to continue.
Press Enter. A second MultiChange Execution screen appears.
Script Processor * MultiChange Execution screen. ------------------- Script Processor * MultiChange Execution ------------------ .
. Command ===> .
. .
. F Initiate Processing In Foreground. .
. B Initiate Processing In Background. .
. .
. Input Script Data Set: PMIJSS0.HIPER.VTAM.SCRIPTS .
. Output Script Data Set: PMIJSS0.HIPER.VTAM.SCRIPTS.OUTPUT .
. .
. Input Script Name Output Script Name .
. SAMP0000 SAMP0000 .
. .
. .
. .
. .
. .
. .
. Replace Existing Members . . . Y (Y/N) .- Enter the Input Script Name (the scripts from the input data set to be processed). Enter an asterisk (*) to process all members in the data set.
- Enter the Output Script Name (the names of the modified scripts stored in the output data set). If no name is entered, the modified script is stored under the same name as the input script.
- Specify whether you want to Replace Existing Members. Enter Y to overwrite an existing script.
- Use one of the primary commands (F or B) to select the type of processing. Select F to process the script or scripts in TSO foreground. Select B to process the script or scripts in TSO background (batch).
Background Processing
When you select B (Background Processing), the Script Processor MultiChange Background Execution screen appears. This screen contains job statement information, region size, message class, and script processor library data set prior to generating the JCL. You can confirm or modify this information, then enter the GO command to generate the JCL for this background process.
MultiChange Script Processor screen. -------------------------- MULTICHANGE Script Processor ------------- ------- .
. Command ===> .
. .
. Go To generate and display the JCL .
. End To terminate background processing .
. .
. Job Statement Information: .
. .
. .
. .
. .
. .
. .
. Region Size. . . . . . . . . 4096K .
. Sysout Class . . . . . . . . * .
. Script Processor Library . . 'VP.CMU.QQF172.SQQFEXEC' .- Enter the Job Statement Information JCL for the job run.
- Enter the Region Size for the job.
- Enter the Sysout Class for background processing messages.
- Enter the Script Processor Library that contains your multichange script processor programs.