GGGGGGG RRRRRRRRR OOOOOOO UUUU UUUU PPPPPPPPP …...1.1 List Conversion -- Introduction - PROGRAM...

GGGGGGG RRRRRRRRR OOOOOOO UUUU UUUU PPPPPPPPP 11 GGGGGGGGG RRRRRRRRR OOOOOOOOO UU UU PPPPPPPPP 111 GG GG RR RR OO OO UU UU PP PP 11 GG RR RR OO OO UU UU PP PP 11 GG GGGG RRRRRRRR OO OO UU UU PPPPPPPP 11 GG GG RRRRRRR OO OO UU UU PPPPPPP 11 GG GG RR RR OO OO UU UU PP 11 GGGGGGGGG RR RR OOOOOOOOO UUUUUUUUU PP 111111 GGGGGGG RRRR RRRR OOOOOOO UUUUUUU PPPP 111111

List Conversion System Reference Guide November 2000 Group 1 Software, Inc. Copyright Group 1 Software, Inc. 1981-2000

GGGGGGG RRRRRRRRR OOOOOOO UUUU UUUU PPPPPPPPP 11 GGGGGGGGG RRRRRRRRR OOOOOOOOO UU UU PPPPPPPPP 111 GG GG RR RR OO OO UU UU PP PP 11 GG RR RR OO OO UU UU PP PP 11 GG GGGG RRRRRRRR OO OO UU UU PPPPPPPP 11 GG GG RRRRRRR OO OO UU UU PPPPPPP 11 GG GG RR RR OO OO UU UU PP 11 GGGGGGGGG RR RR OOOOOOOOO UUUUUUUUU PP 111111 GGGGGGG RRRR RRRR OOOOOOO UUUUUUU PPPP 111111

List Conversion System

Reference Guide

Release 2.7 November 2000

Group 1 Software, Inc.

Copyright Group 1 Software, Inc. 1981-2000

- Table of Contents + _________________ 0 0Table of Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0List Conversion -- Introduction. . . . . . . . . . . . . . . . . . . . 1.1 0List Conversion -- System Overview . . . . . . . . . . . . . . . . . . 2.1

Brief Explanation of Parameters . . . . . . . . . . . . . . . . . . 2.4 File Definition Parameters. . . . . . . . . . . . . . . . . . . . 2.4 Record Processing Parameters. . . . . . . . . . . . . . . . . . . 2.6

General Information . . . . . . . . . . . . . . . . . . . . . . . . 2.11 TAPExx Parameter Card . . . . . . . . . . . . . . . . . . . . . . 2.11 Parameters for TAPE/DISK Exit Routines. . . . . . . . . . . . . 2.16 TAPE/DISK Exit Routines - Additional Notes. . . . . . . . . . . 2.17

SYNCHK Parameter Card . . . . . . . . . . . . . . . . . . . . . . 2.19 PAGESZ Parameter Card . . . . . . . . . . . . . . . . . . . . . . 2.23 UHDnx Parameter Card. . . . . . . . . . . . . . . . . . . . . . . 2.25 UFTnx Parameter Card. . . . . . . . . . . . . . . . . . . . . . . 2.26 EXITOP--General-Purpose Output Exit . . . . . . . . . . . . . . . 2.27 Alternate names for programs. . . . . . . . . . . . . . . . . . . 2.31 IOMODS Parameter Card . . . . . . . . . . . . . . . . . . . . . 2.31

Auxiliary Parameter File. . . . . . . . . . . . . . . . . . . . . 2.31 Relocation for Subroutines. . . . . . . . . . . . . . . . . . . . 2.33

0Parameter Definition . . . . . . . . . . . . . . . . . . . . . . . . . 3.1 TAPExx Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.3 HEADER Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.5 END OF FILE Paramenter Card . . . . . . . . . . . . . . . . . . . . 3.7 BANNER WORD Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.9 BLOCK SIZE Parameter Card . . . . . . . . . . . . . . . . . . . . . 3.11 RECORD SIZE Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.13 O/P-FILE DTF Parameter Card . . . . . . . . . . . . . . . . . . . . 3.15 PUNCH KEY Parameter Card. . . . . . . . . . . . . . . . . . . . . . 3.17 PUNCH KEYS Parameter Card . . . . . . . . . . . . . . . . . . . . . 3.18 SUMMARY FILE CODE CONSTANT Parameter Card . . . . . . . . . . . . . 3.19 SUMMARY FILE CODE Parameter Card. . . . . . . . . . . . . . . . . . 3.20 CONSTANT Parameter Card . . . . . . . . . . . . . . . . . . . . . . 3.21 CHCKPT Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.23 END Parameter Card. . . . . . . . . . . . . . . . . . . . . . . . . 3.25 START AFTER Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.27 STOP AFTER Parameter Card . . . . . . . . . . . . . . . . . . . . . 3.29 REJECT CONTROL Parameter Card . . . . . . . . . . . . . . . . . . . 3.31 ACCEPT APO/FPO Parameter Card . . . . . . . . . . . . . . . . . . . 3.33 ACCEPT CANADA Parameter Card. . . . . . . . . . . . . . . . . . . . 3.34 ACCEPT AUSTRALIA Parameter Card . . . . . . . . . . . . . . . . . . 3.35 STATE SELECT Parameter Card . . . . . . . . . . . . . . . . . . . . 3.37 STATE REJECT Parameter Card . . . . . . . . . . . . . . . . . . . . 3.38 ACTIVATE EXIT ROUTINE 9 . . . . . . . . . . . . . . . . . . . . . . 3.41 ASCII TRANSLATE Parameter Card. . . . . . . . . . . . . . . . . . . 3.43 LOWER/UPPER TRANSLATE Parameter Card. . . . . . . . . . . . . . . . 3.44 TRANSLATE CARD Parameter Card . . . . . . . . . . . . . . . . . . . 3.45

MVAR Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.47 FVAR Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.49 FIELD SHIFT Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.53 COLLAPSE NAME Parameter Card. . . . . . . . . . . . . . . . . . . . 3.55

- SCAN AND SPLIT Parameter Card . . . . . . . . . . . . . . . . . . . 3.57 COMPARE REJECT or ACCEPT Parameter Card . . . . . . . . . . . . . . 3.59 LEFT JUSTIFY IP Parameter Card. . . . . . . . . . . . . . . . . . . 3.61 RIGHT JUSTIFY IP Parameter Card . . . . . . . . . . . . . . . . . . 3.63 EXTRACT SECOND NAME Parameter Card. . . . . . . . . . . . . . . . . 3.65 ACTIVATE EXIT ROUTINE Parameter Card. . . . . . . . . . . . . . . . 3.67 Parameters for the exits. . . . . . . . . . . . . . . . . . . . . 3.68 Example of exit . . . . . . . . . . . . . . . . . . . . . . . . . 3.69 ANS COBOL exits under DOS . . . . . . . . . . . . . . . . . . . . 3.70

ISOLATE FULL NAME Parameter Card. . . . . . . . . . . . . . . . . . 3.71 COMPANY NAME Parameter Card . . . . . . . . . . . . . . . . . . . . 3.75 REJECT COMPANIES Parameter Card . . . . . . . . . . . . . . . . . . 3.76 ISOLATE PART NAME Parameter Card. . . . . . . . . . . . . . . . . . 3.77 GENDER CODE Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.79 ISOLATE ADDRESS PARTS Parameter Card. . . . . . . . . . . . . . . . 3.81 ISOLATE CITY STATE ZIP Parameter Card . . . . . . . . . . . . . . . 3.85 ISOLATE CITY STATE Parameter Card . . . . . . . . . . . . . . . . . 3.86 STATE LOOK UP Parameter Card. . . . . . . . . . . . . . . . . . . . 3.87 STREET SPLIT Parameter Card . . . . . . . . . . . . . . . . . . . . 3.89 TITLE TABLE Parameter Card. . . . . . . . . . . . . . . . . . . . . 3.91 CVTB Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.93 PACK Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.95 CVTD Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.97 UNPK Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.99 MOVE Parameter Card . . . . . . . . . . . . . . . . . . . . . . . . 3.101 EXPAND POSTAL CODE Parameter Card . . . . . . . . . . . . . . . . . 3.103 EXPAND AUSTRALIAN STATE Parameter Card. . . . . . . . . . . . . . . 3.104 TABLE LOOKUP Parameter Card . . . . . . . . . . . . . . . . . . . . 3.105 RANGE LOOKUP Parameter Card . . . . . . . . . . . . . . . . . . . . 3.107 FORMAT Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.109 EXPAND STREET ADDRESS Parameter Card. . . . . . . . . . . . . . . . 3.113 LEFT JUSTIFY OP Parameter Card. . . . . . . . . . . . . . . . . . . 3.115 CENTER Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.117 RIGHT JUSTIFY OP Parameter Card . . . . . . . . . . . . . . . . . . 3.119 ZIP SEQUENCE CHECK Parameter Card . . . . . . . . . . . . . . . . . 3.121 ZIP RANGE Parameter Card. . . . . . . . . . . . . . . . . . . . . . 3.123 ZIP CODE REJECT Parameter Card. . . . . . . . . . . . . . . . . . . 3.125 SELZIP Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.127 STATE VERIFY Parameter Card . . . . . . . . . . . . . . . . . . . . 3.129

STATE COUNTS Parameter Card . . . . . . . . . . . . . . . . . . . . 3.131 SEQUNO Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 3.133 SPLIT FUNCTION. . . . . . . . . . . . . . . . . . . . . . . . . . . 3.135 ADJUST RDW Parameter Card . . . . . . . . . . . . . . . . . . . . . 3.137 PRINT Parameter cards . . . . . . . . . . . . . . . . . . . . . . . 3.139 PRINT FIELDS Parameter cards. . . . . . . . . . . . . . . . . . . . 3.143

0Program MW210 -- Tables. . . . . . . . . . . . . . . . . . . . . . . . 4.1 State/Sectional Center Table. . . . . . . . . . . . . . . . . . . . 4.2 Reason for Record Rejection . . . . . . . . . . . . . . . . . . . . 4.3

0Program MW210 -- Operating Instructions. . . . . . . . . . . . . . . . 5.1 Additional Operating Instructions . . . . . . . . . . . . . . . . . 5.2 Sample OS JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.3 Sample DOS JCL. . . . . . . . . . . . . . . . . . . . . . . . . . . 5.4

-Callable List-Conversion Subroutines . . . . . . . . . . . . . . . . . 6.1 Routine EXAP -- Extended Isolate Address Parts. . . . . . . . . . . 6.3 Routine ISAP -- Isolate Address Parts . . . . . . . . . . . . . . . 6.7 Routine ISFN -- Isolate Full Name . . . . . . . . . . . . . . . . . 6.11 Routine XTSP -- Extended Street Split . . . . . . . . . . . . . . . 6.13 Routine STSP -- Street Split. . . . . . . . . . . . . . . . . . . . 6.15

0Program MW211 -- Conversion Summary Program. . . . . . . . . . . . . . 7.1 Header Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1 Summary Card. . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.1 Operating Instructions. . . . . . . . . . . . . . . . . . . . . . . 7.3 Sample DOS JCL. . . . . . . . . . . . . . . . . . . . . . . . . . . 7.5 Sample OS JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.5

0DCOMPRES Program -- Extract program(s) from Delivery Tape. . . . . . . 8.1 Narrative and Flow. . . . . . . . . . . . . . . . . . . . . . . . . 8.1 HEADER Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 8.3 TAPExx Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 8.5 CONTRL Parameter Card . . . . . . . . . . . . . . . . . . . . . . . 8.7 INSERT Control Card . . . . . . . . . . . . . . . . . . . . . . . . 8.9 COPY Control Card . . . . . . . . . . . . . . . . . . . . . . . . . 8.11 Operating Instructions. . . . . . . . . . . . . . . . . . . . . . . 8.13 Sample DOS JCL. . . . . . . . . . . . . . . . . . . . . . . . . . . 8.15 Sample OS JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.16

0Input/Output Section . . . . . . . . . . . . . . . . . . . . . . . . . 9.1 Conversion Summary Card Layout. . . . . . . . . . . . . . . . . . . 9.3 List Conversion Summary Statistics (FILEOS) . . . . . . . . . . . 9.5 Sample Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . 9.7

0Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1

1.1 1Group 1 Software -- List Conversion System List Conversion -- Introduction

- PROGRAM MW210 is a parameter driven list conversion program that allows several options to the user to make for quick and easy conversion of mailing lists on magnetic tape.

--0 PROBLEM: How do I convert the many different tape

files that come into my installation each year quickly, easily and without high pro-gramming costs?

-- SOLUTION: GROUP 1's "MW210" is a computer program that,

via parameter cards, describes the input and output tape formats and converts even the most complex name and address files from one format to another.

-- EXAMPLE: Isolate the different elements of a name

field: title, first name, middle initial, surname, maturity title, professional title; split up a city-state-ZIP Code field into its three elements; string together a house number, street directional, and street name to form an address line.

1

1Group 1 Software -- List Conversion System 2.1 List Conversion -- System Overview

- Parameter cards define the input and output records and the processing that is to take place between the read and write. Some parameters control the file definition and others control the processing of the data for each record.

0 Parameters are read, edited and processed at initialization time. If the parameters are error-free, the tape files are opened, processed and closed according to the parameters presented. If parameter errors are detected, the tape files are not opened and the job is terminated.

0 Records are read into an 'Input Area' and processed according to the parameters supplied. The parameters cause the data to be re-organized to the user's specifications. In order to work with the data, some of the parameters use 'Work Areas'; these 'Work Areas' are defined below. The 'Output Area' is the area that will be written as the final record. Each data element desired in the output record must be explicitly placed in the Output Area via Parameter Cards. The Input Area is the size of the Input record, up to 9999 characters; the Output Area is the size of the Output records up to 9999 characters.

0


NAME OF AREA

- HSE DIR STR PST DSG APT CTY STE

ZIP

C01 . . . C20 A01

A02

A03

A04

A05 A06 N01 N02 N03 N04 N05 N06 S01 . . . S12 W01-W99 or W001-w256

LENGTH DESCRIPTION 10 House Number 2 Street Directional 35 Street Name 2 Post Directional 4 Apartment Type Designator 7 Apartment Type Number 35 City Name 2 State Abbreviation

or Province Abbreviation 11 ZIP Code or Postal Code

Canadian Postal Codes will be stored as 6-character Codes regardless of original format.

35 each Constant Areas for 1 to 20 optional user-supplied constants

35

50 Fifth from Last Address Line

50 Fourth from Last Address Line

50 Third from Last Address Line

50 Second from Last Address Line

50 Next to Last Address Line 50 Last Address Line 35 Title of Respect 35 First Name/Initial 35 Middle Name/Initial 35 Family Surname 35 Maturity Suffix 35 Professional Title 50 each Scan and Split areas up

to 12 areas

50 256 Single work area of 256

contiguous positions - The above Work Areas are each cleared to blanks as each record is

read.


+ - The following pages explain briefly the parameters that are

available. The parameters are separated into two groups: 0 (1) File definition and miscellaneous parameters 0 (2) Processing parameters.

The Processing parameters are presented here in the order they will be executed for each record processed. The Processing parameters will not be executed in the

+ ___ order they are presented to the program.


0Brief Explanation of Parameters -- File Definition Parameters 0 PARAMETER KEY WORD FUNCTION - HEADER Defines whether the input

file is labeled or not (DOS & OS/3). 0 END OF FILE Defines non-standard end of

file indicators on the input file.

0 BANNER WORD Defines the length of any leading character(s) in the beginning of each input block.

0 BLOCK SIZE This parameter is ignored. 0 RECORD SIZE Defines the input record size. 0 O/P-FILE DTF Defines the output file

characteristics. (DOS & OS/3) 0 PUNCH KEY Punches a Summary Card with control

statistics. 0 CONSTANT Permits the user to put constants

into the output record. 0 CHCKPT Allows for CHECKPOINT processing. 0 END This parameter is ignored. 0 START AFTER Option to skip a group of records before

initiating processing. 0 STOP AFTER Testing option to limit processing. 0 REJECT CONTROL Limits number of rejects permitted. 0 ACCEPT APO/FPO Allows APO/FPO ZIP Codes to be

accepted as valid. 0 ACCEPT CANADA Allows Canadian Postal Codes as

well as US ZIP Codes to be accepted. 0 ACCEPT AUSTRALIA Allows Australian Post Codes as

well as US ZIP Codes to be accepted. 0 STATE REJECT or STATE SELECT Allows rejection or selection of

records by State (as determined by ZIP Code).

0 TAPE or DISK Activates and defines optional files.


0Brief Explanation of Parameters -- File Definition Parameters 0 PARAMETER KEY WORD FUNCTION - ACTIVATE EXIT ROUTINE 9 Invokes the specified exit routine at

end of job--that is, after all the records have been processed.


0Brief Explanation of Parameters -- Record Processing Parameters 0 PARAMETER KEY WORD FUNCTION - ASCII TRANSLATE Enables translation from ASCII to

EBCDIC. 0 LOWER/UPPER TRANSLATE Enables translation from lower-case

to upper-case characters. 0 TRANSLATE CARD Enables translation of characters. 0 MVAR Allows movement of fields from a

variable-length record which may be missing or partially present.

0 FVAR Formats (strings together) input fields, constants, unpacked data, and work areas.

0 COLLAPSE NAME Collapses blanks from two part surname fields, and removes and collapses apostrophes from designated fields.

0 FIELD SHIFT Allows non-blank fields to be shifted into blank positions, when a data element is in one of several positions.

0 SCAN AND SPLIT Scans for delimiters and splits into separate fields.

0 COMPARE REJECT or ACCEPT Allows the user to reject records based on constant data in the parameter card.

0 LEFT JUSTIFY IP Left justifies data within an input field.

0 RIGHT JUSTIFY IP Right justifies data within an input field.

0 EXTRACT SECOND NAME Extracts the second name from a compound name line such as one containing 'JOHN & MARY JONES'.

0 ACTIVATE EXIT ROUTINE 1 Input user exit. 0 ISOLATE FULL NAME Separates name field into Title,

Given name, Middle name, Surname, Maturity title, Business title.

0 COMPANY NAME Checks Company indicators and allows flexibility in formatting Company names.

0 REJECT COMPANIES Rejects Companies when recognized.


0Brief Explanation of Parameters -- Record Processing Parameters 0 PARAMETER KEY WORD FUNCTION - ISOLATE PART NAME Separates "part" name field into

Title, Given name, and Middle name. 0 GENDER CODE Allows a Gender Code to be placed

in the output based on a first name field.

0 ISOLATE ADDRESS PARTS Isolates address lines into fixed areas.

0 ISOLATE CITY STATE ZIP Isolates a City-State-ZIP line into fixed areas.

0 ISOLATE CITY STATE Isolates a City-State line into fixed areas.

0 STATE LOOK UP Generates a two position State Code from the sectional center.

0 STREET SPLIT Splits a Street Address into House Number, Directional, and Street Name.

0 TITLE TABLE Allows conversion of titles from one form to another.

0 CVTB Permits the user to convert numeric character data in the input or work areas to a binary output field.

0 PACK Permits the user to pack fields into the output record.

0 CVTD Permits the user to convert binary fields in an input or work area to packed decimal in the output record.

0 UNPK Permits the user to unpack data from the input record and place parts or all of the unpacked data into the output record.

0 MOVE Permits the user to move isolated fields, constants, unpacked data, and input data to the output record.

0 EXPAND POSTAL CODE Allows a printable-form ZIP Code or Canadian Postal Code to be constructed in the Output Area or a Work Area.


0Brief Explanation of Parameters -- Record Processing Parameters 0 PARAMETER KEY WORD FUNCTION - EXPAND AUSTRALIAN STATE Allows conversion from the two-character

pseudo Australian State abbreviation to the three-character standard Australian State/Territory abbreviation.

0 TABLE LOOKUP Permits placement of a value from a table in the output record, based on an argument in the input record.

0 RANGE LOOKUP Permits placement of a value from a table in the output record, based on an argument in the input record falling within defined ranges.

0 FORMAT Permits the user to format (string together) isolated fields, constants, unpacked data and input data to the output record.

0 EXPAND STREET ADDRESS Expands street abbreviations to their

proper spellings. 0 LEFT JUSTIFY OP Left justifies data within an output

field. 0 CENTER Allows the centering of the data in an

Output field. 0 RIGHT JUSTIFY OP Right justifies data within an output

field. 0 ACTIVATE EXIT ROUTINE 2 Output user exit. 0 ZIP SEQUENCE CHECK Activates a ZIP Code sequence check

on the output records. 0 ZIP RANGE Allows selection of a single ZIP Code

range for the output records. 0 ZIP CODE REJECT Allows rejection of records by specific

ZIP Codes, by specific Canadian Postal Codes, or by specific 3-digit ZIP or Postal Codes.

0 SELZIP Allows for selection of records by ZIP Code ranges for the output file

0 STATE VERIFY Allows verification of the State Abbreviation against the ZIP Code, on the output records.


0Brief Explanation of Parameters -- Record Processing Parameters 0 PARAMETER KEY WORD - STATE COUNTS

0 SEQUNO

0 SPLIT

0 ADJUST RDW

0 PRINT REJECT

0 PRINT INPUTS

0 PRINT OUTPUT

0 PRINT FIELDS 1

FUNCTION Generates State Counts for the converted output file. Puts sequence numbers on the output records. Allows for splitting of output Key Codes according to parameter. Permits setting or modification of the RDW in variable-length output records. Permits printing of rejected records. Permits printing of those Input records which are successfully converted. Permits printing of successfully converted output records. Permits Output printing by field.


0General Information 0TAPExx Parameter Card - All EXEC-level GROUP 1 Mail Management programs require a TAPExx

or DISKxx card to trigger processing of each input or output file (except the card reader and printer). The format of the card required is the same for all programs, as follows:

- CARD COLUMNS FIELD DESCRIPTION 0 01 - 04 PARAMETER KEYWORD - Must contain 'TAPE' or 'DISK'

to indicate the DTF name to be used. 0 05 - 06 FILE ACTIVATOR - Must contain a two-position code

that identifies the file to be activated. (See the list of File Activators for each EXEC-level program.)

0 08 - 11 BLOCK SIZE - Must contain the block size of the file indicated.

0 For a VSAM keyed file, this field should contain the same value as the Record Size (columns 13-15). (VSAM keyed files are used only for specific purposes, such as reference files for keyed lookup, usage recording, etc. Each usage will be accompanied by specific instructions.)

0 For a VSAM numbered file, this field should contain the size of the "nominal" block, as defined in the file creation process. See the instructions for creating the file. (VSAM numbered files are used only for specific purposes, such as "indexed" Master

Files, Audit File records, etc. Each usage will be accompanied by specific instructions.)

0 Note: If necessary, this field may be extended + ____

one position to the left, allowing the entry of a five-digit block size in columns 7-11.


0General Information 0TAPExx Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 13 - 15 RECORD SIZE - Must contain the record size of the

file indicated. 0 For an indexed Master file or the associated Index,

column 12 must contain 'X' and columns 13-15 must contain the number of blocks per track. If using VSAM (numbered), columns 13-15 should be set to '001'. Note that the indexed Master File specification is not valid for FBA devices in a DOS environment (unless using VSAM), nor available at all under OS/3.


one position to the left, allowing the entry of a four-digit record size in columns 12-15.

0 Record sizes larger than 9999 can be specified by using the letters 'A' through 'W' in column 12 to represent high-order 'digits' with the values 10 through 32, respectively.

0 16 - 16 RECORD FORM - Must be blank for fixed-length records or 'V' for variable-length blocked records.

0 17 - 17 LABELS - Must contain 'S' for standard-label files, or 'N' for non-labeled files.

0 18 - 18 ASCII TRANSLATE - For input files, if this column contains 'A', then each input record will be translated from ASCII code to EBCDIC. For variable length records, the RDW will not be translated. This option should be used only if the records contain no binary or packed fields that will be needed, as fields of this sort can not be processed correctly via the translate.

0 19 - 19 BUFFERS - Must contain '1' or '2', indicating the number of buffers to use.


0General Information 0TAPExx Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 21 - 24 DEVICE TYPE - May contain one of the following to

indicate the device to which the file is assigned. 0 For OS or DOS: VSAM if the file is either an

Indexed Master File stored under VSAM, or a VSAM keyed or numbered file constructed in accordance with specific instructions for that file. For OS, no value of this field except 'VSAM' has any significance.

For DOS: TAPE, 2311, 2314, 3310, 3330, 3340, 3350, 3370, 3375, 3380, or FBA

For OS/3: TAPE or DISK For either: IGNR, which causes the following:

OPEN and CLOSE requests will be ignored. READ requests will be treated as if end-of-file were reached. WRITE requests will be ignored.

0 Note that for DOS, the IGNR device type is more powerful than the IGNORE JCL option, because it works properly for input files.

0 Blank defaults to TAPE for TAPExx cards, and to 2314 or DISK for DISKxx cards.


0General Information 0TAPExx Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 26 - 26 TAPE REEL HANDLING - Must contain one of the

following codes to indicate the desired handling of each reel of magnetic tape. This column is ignored for files assigned to disk devices. The codes are:

0 blank - (normal) Magnetic tape reels will be rewound at each Open or Close operation. For no-label Tape files or multi-volume standard-label files, this treatment will be changed to 'U' (see below) if a multi reel or multi file situation is detected.

0 'U' - Magnetic tape reels will be rewound at Open operations, and unloaded at Close operations.

0 'X' - Magnetic tape reels will not be repositioned at either Open or Close operations.

0 In general, blank should be used for intermediate occurrences of a single-reel file; 'U' should be used for multi-reel files and for the final occurrence of single-reel files; and 'X' should be used for files which require non-standard positioning of the tape reel (which can be accomplished via MTC commands or the equivalent).

0 28 - 28 MULTIPLE STANDARD-LABEL FILES - May contain 'M' to indicate that the input file consists of more than one standard-label file. The operator will be queried for EOF/EOV at the end of each of the input files.

0 54 - 63 ALTERNATIVE FILE TREATMENT - May contain values which cause alternative treatment of the file, as follows:

0 54 - 56 ALTERNATE SYS NUMBER - If these columns are numeric, then the value entered will be used as the SYS number for the file, instead of using the SYS number noted in the Operations section. In this case, columns 57-63 are ignored.


0General Information 0TAPExx Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 54 - 61 EXIT ROUTINE NAME - If non-blank, these columns

are treated as the name of an exit routine which is to handle the I/O operations. In this case, the TAPE/DISK card is ignored, the exit routine will be given control for each operation on the file (see description following), and column 63 is used as the COBOL indicator as follows.

0 63 - 63 COBOL INDICATOR (DOS ONLY) - If the exit routine is written in ANS COBOL under DOS, place a 'C' in this column.

0 65 - 71 PRECISE REEL CUT-OFF - May contain a number to specify a precise number of records for each reel of an output tape file. If specified, then each reel of the file will contain exactly this number of records. This field will be ignored if the file is not assigned to tape, if it is not numeric, if it is zero, or if the file for which specified is an input file. This option is ignored if an exit routine is specified in columns 54-63.

0 General: + ________ 0 The TAPExx/DISKxx card is required in all systems to activate the

file indicated. Columns 54 and up are used in all systems for the purposes indicated. If an exit routine is not specified, then columns 7-28 are ignored in OS systems (this information is taken from the JCL provided), and are required in DOS and OS/3 systems.

0 Under DOS and OS operating systems, an Indexed Master File, or the non-sequential Index for an Indexed Master File, may optionally be stored as a VSAM relative-record file. For either Operating System,

+ ______ the word 'VSAM' in the device type field (columns 21-24) will cause the file defined to be treated as a VSAM file. Under OS, the file attributes are obtained when the file is opened. For DOS, the block size must be entered in columns 7-11, an 'X' must be placed in column 12, and the value '001' must be placed in columns 13-15; the remaining fields are not used when the file is VSAM.


0General Information 0TAPExx Parameter Card Parameters for TAPE/DISK Exit Routines - The following parameters are passed to the TAPE/DISK Exit Routines

via standard linkage conventions at each I/O operation request: - 1) A word-aligned 16-byte area as follows: 0 File Activator, 2 bytes

Function byte, as follows: 'O' for open 'C' for close 'R' for read 'W' for write

Binary SYS number, one byte The remainder of the area is reserved

0 2) A word-aligned 16-byte area which must be filled by the Exit Routine as follows:

0 Record length (halfword) - Must be set to fixed or maximum record length by the Open call

Must be set to the length of the current record by the Read call, or to zero to indicate end-of-file

Not used by the Close call. Record type (byte) - Must be set to 'F' (fixed-length records),

'V' (variable-length records), or 'U' (undefined records) by the Open call

Not used by the Read, Write, or Close calls The remainder of the area is reserved.

0 3) The area containing (for Write) or to contain (for Read) the next record. This area should not be used by the Open or Close routines.

0 4) A word-aligned 80-byte area containing the TAPE or DISK card image.


0General Information 0TAPExx Parameter Card TAPE/DISK Exit Routines - Additional Notes - 1. For OS and DOS, the Tape/Disk exit routines are always

dynamically loaded at execution time. For Univac OS/3, the exit routine must be linked with the primary program (see below).

0 2. Under DOS, if the Exit Routine is written in ANS COBOL, the following must be observed in order for the exit routine to "know" that it is a called routine:

0 A. Create an assembler program named MNS0ADDR as follows: 0 MNS0ADDR START

DC V(ILBDMNS0) END

0 B. Link the exit routine with this 'program', as follows: 0 INCLUDE MNS0ADDR

INCLUDE exit ENTRY exit

0 C. Now the eight-byte 'program' MNS0ADDR will immediately precede the entry-point of the exit, providing its caller with the address of the flag byte to be set when an ANS COBOL exit is to be called.

0 D. Place a 'C' in column 63 of the TAPE/DISK card to cause the COBOL logic to be invoked.

0 3. For Univac OS/3 systems, the exit routine must be linked statically with the main program. This is accomplished as follows:

0 A. Find the label TAPDSK in the main program. 0 B. Following this label is an entry for each TAPE/DISK card

(file) possible. Locate the entry for the file that is to be handled by the exit routine.

0 C. Change the definition of the entry to place a V-type address-constant referring to the exit's entry-point at displacement 36 in the entry located.

0 D. Regardless of the contents of the TAPE/DISK card, the exit routine will now be invoked as noted above.


0General Information 0SYNCHK Parameter Card - The SYNCHK parameter allows the content of any sequential file

activated via a TAPExx or DISKxx parameter to be checked at defined intervals, ensuring that the correct file is read and that no data has been lost. For an output file, a record is written every nth record, containing the record number and the contents of a user defined control field, up to 30 characters. When the same file is read (it must still be in the same sequence), the synchronization file

+ ____ is also read, and the contents of the input file are checked against the data stored in the synchronization file. When a discrepancy is detected, it is noted on the console, and one of three dispositions takes effect: 1) continue; 2) cancel the job; or 3) ask the operator for one of the first two choices.

0 Normally, this procedure is done when there is a large file which must be transmitted exactly as written. If checkpoints are also taken, then if a discrepancy is detected, the job can be cancelled. Then the cause of the error can be found, corrective steps taken if necessary, and the job restarted again from the last checkpoint at which the data was in sync. Note that the field selected should most likely contain some field which indicate the point in the file at which any record is found, so that the discrepancy messages can be readily interpreted. For many files, the ZIP or Postal code serves nicely.

0 The format of the SYNCHK parameter is the same for all program as For simplicity, the (large) file whose content is critical, will be referred to as the "checked" file, and the file of synchronization records will be referred to as the "sync" file.

- CARD COLUMNS FIELD DESCRIPTION 0 01 - 06 PARAMETER KEYWORD - Must contain 'SYNCHK'. 0 08 - 09 ACTIVATOR OF CHECKED FILE - Must contain the

two-character File Activator of the file to be checked. If that file is not opened, then the sync file will not be opened either. Up to 3 SYNCHK cards (for different files) may be supplied for any single execution.

0 11 - 13 CONTROL FIELD LOCATION - Must contain the location, in the checked file records, of the field which is to be checked. This location is applied to the records of the checked file at read or write time, in the format of the records on the tape or disk.

0 If necessary, this field may be extended one position to the left, permitting the entry of a four-digit location in columns 10-13.


0General Information 0SYNCHK Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 15 - 16 CONTROL FIELD LENGTH - Must contain the length

of the control field, up to 30. 0 18 - 24 FREQUENCY OF SYNCHRONIZATION - Must contain the

number of records between successive synchronization checks. For an input file, of course, the actual number of records between checks is determined by the input sync file, but this field is still validated.

0 26 - 26 ERROR DISPOSITION - Must contain one of the following codes to indicate the treatment desired when a discrepancy is detected between the checked file and the sync file:

0 C - continue processing; in this case, the only evidence of the discrepancy will appear on the console log

E - terminate processing O - ask the operator for one of the above

treatments 0 28 - 30 SYS NUMBER FOR SYNC FILE - Must contain the SYS

number to use for the sync file. No TAPE/DISK card may be provided for the sync file, but it must be assigned (that is, a DD or ASSGN card must be present, depending on the operating system). For DOS and OS/3 systems, the DTF name used for the sync file will be SYNCxx, where xx

+ __ is the File Activator for the checked file.

0 32 - 35 DEVICE TYPE FOR SYNC FILE - For DOS and OS/3, must contain one of the device types noted under the TAPExx/DISKxx parameter card. If omitted, TAPE will be assumed. This field is neither used nor verified under OS.

0 37 - 37 LABELS FOR SYNC FILE - For DOS and OS/3, must contain one of the following codes to indicate whether or not the sync file has or is to have standard labels. For DOS and OS/3, the value will always be verified, but will be ignored if the sync file device is not tape. For OS, this field is neither used nor verified. The codes are:

0 S - Standard labels

N - no labels blank - defaults to 'S'

________ _______ __________


0General Information 0SYNCHK Parameter Card + - The records written to the sync file will be 80 characters long,

and will be written unblocked (for OS, the blocking will be determined by the DD statement). Each record will have the following form:

0 Field Description/Contents + ___________________________________ 0 Record Identification

contains 'SYNC POINT' 0 (blank) 0 File Activator of checked file 0 (blank) 0 Number of record in checked file 0 (blank) 0 End-of-file indicator

X if the checked file should be at end-of-file

blank otherwise 0 (blank) 0 constant 'DATA=', or blank if

25 is 'X' 0 control field data, or blank if

position 25 is 'X' 0 (blank) 1

1Group 1 Software -- List Conversion System

Format Length Positions

C 10 001 - 010

- 1 011 - 011 C 2 012 - 013 - 1 014 - 014 9 9 015 - 023 - 1 024 - 024 C 1 025 - 025

- 1 026 - 026 C 5 027 - 031

C 30 032 - 061

- 19 062 - 080

2.23 List Conversion -- System Overview

0General Information 0PAGESZ Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'PAGESZ'. 0 This parameter card is provided to permit you

to alter the standard pagination of reports, which is set up for 11-inch paper printed at six lines per inch.

0 08 - 10 PAGE SIZE - May contain the maximum number of lines to be printed on any page, including headers. The minimum permissible value is 25 and the default is 60.

0 12 - 12 PRINT TRANSLATION - Must contain one of the following codes to indicate whether a lower-to-upper case character translation is to occur before printing a print line:

0 Y - Yes, a translation is to occur N - No translation is to occur

blank - defaults to N

0

1Group 1 Software -- List Conversion System 2.25

0General Information 0UHDnx Parameter Card - CARD COLUMNS - 01 - 03

0 04 - 04

0 05 - 05

0 07 - 72

List Conversion -- System Overview

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'UHD'. UHDnx parameter cards may optionally be used in any Group 1 EXEC-level program to define one to four lines of user-controlled report heading, which (if present) will be printed above the normal (program-generated) report headings. When UHDnx cards are used, the normal report headings will be double-spaced beneath those generated by the UHDnx cards. USER HEADING LINE NUMBER - Must contain '1' to '4' to specify the first through the fourth line of heading. LEFT OR RIGHT SIDE OF LINE - Must contain an 'A' or a 'B' to indicate that the left ('A') or right ('B') side of the line is being defined by this card. The left side of a line is print positions 1 through 66, and the right side is print positions 67 through 132. DATA TO PRINT - Must contain the 66 characters of text which is to be used as the left or right side of the specified heading line.


0General Information 0UFTnx Parameter Card - CARD COLUMNS - 01 - 03 0

0 04 - 04

0 05 - 05

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'UFT'. UFTnx parameter cards may optionally be used in any Group 1 EXEC-level program to define one to four lines of user-controlled report footer, which (if present) will be printed at the bottom of each page of the report(s) produced. When UFTnx cards are used, the footers defined will be printed double-spaced below the last line of a full page of report. USER FOOTER LINE NUMBER - Must contain '1' to '4' to specify the first through the fourth line of footer. LEFT OR RIGHT SIDE OF LINE - Must contain an 'A' or a 'B' to indicate that the left ('A') or right ('B') side of the line is being defined by this card. The left side of a line is print positions 1 through 66, and the right side is print positions 67 through 132.

0 07 - 72 DATA TO PRINT - Must contain the 66 characters of text which is to be used as the left or right side of the specified footer line.

1Group 1 Software -- List Conversion System 2.27 List Conversion -- System Overview 0General Information 0EXITOP--General-Purpose Output Exit - All GROUP 1 EXEC-level programs will accept an EXITOP Parameter

card which activates an exit routine which receives control just before each output sequential tape or disk record is written (and before an output TAPExx Exit if one is activated). If the program does not write any output sequential files, or if none are activated, the EXITOP card will have no effect. The format of the EXITOP Parameter card is as follows:

- CARD COLUMNS 0 01 - 06 0 08 - 15

0 17 - 17

0 18 - 80

- General: + _______

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'EXITOP'. EXIT ROUTINE NAME - Must contain the name of the Exit Routine which is to be activated. For OS and DOS systems, the Exit routine will be loaded dynamically when the card is encountered. For OS/3 the Exit routine must be linked with the EXEC-level program, but will not be activated unless the EXITOP card is present. COBOL INDICATOR (DOS ONLY) - If the exit routine is written in ANS COBOL under DOS, place a 'C' in this column. These columns are reserved for use by the Exit routine, and permit information to be conveyed to it by the user.

0 The EXITOP routine receives control before the OPEN, WRITE, and CLOSE operations for each output sequential Tape or Disk file. The Exit routine receives the following parameter list using standard linkage:

0 1) A single byte indicating the function which is about to be performed as follows:

0 O - Open W - Write C - Close

0 2) A two-byte field which contains the File Activator characters for the file involved (by examination of this field, an Exit routine can be activated which operates on only some of the output records which are written by a program).

0 3) The record which is about to be written. For the Open and Close calls, this parameter is undefined and should not be referenced.

0 4) The EXITOP card image.

0


0General Information 0EXITOP--General-Purpose Output Exit Skeletal sample EXITOP routine - Following is a skeletal example of an EXITOP routine, in assembler

language. EXOP TITLE 'SAMPLE EXITOP ROUTINE' EXITOP START

STM R14,R12,12(R13) BALR R12,0 USING *,R12 L R15,=A(SAVEAREA) * SAVE ST R13,4(R15) * AREA ST R15,8(R13) * LINKAGE LR R13,R15 * ESTABLISH NEW SAVE AREA LM R8,R11,0(R1) * PARAMETER ADDRESSABILITY:

* R8 -> O/W/C INDICATOR BYTE * R9 -> FILE ACTIVATOR * R10 -> RECORD TO BE WRITTEN * R11 -> EXITOP CARD IMAGE

CLI 0(R8),C'C' BE CLOSE CLI 0(R8),C'W' BE WRITE

OPEN . . OPEN LOGIC . B EXIT

WRITE . . WRITE LOGIC . B EXIT

CLOSE . . CLOSE LOGIC .

EXIT L R13,4(R13) * UNLINK SAVE AREAS LM R14,R12,12(R13) * RESTORE REGISTERS SR R15,R15 * SET RETURN CODE = ZERO BR R14 * RETURN TO CALLER TITLE 'ADDRESSABLE DATA AREAS' . . ADDRESSABLE DATA AREAS . TITLE 'REMOTE (UNADDRESSABLE) AREAS'

EXITOP1 CSECT SAVEAREA DS 90D 10 LEVELS OF SAVE AREA

.

. ADDITIONAL REMOTE AREAS

.

TITLE 'LITERAL POOL' END EXITOP


0General Information 0EXITOP--General-Purpose Output Exit EXITOP Exit Routines - Additional Notes - 1. For OS and DOS, the EXITOP exit routine is always

dynamically loaded at execution time. For Univac OS/3, the exit routine must be linked with the primary program (see below).

0 2. Under DOS, if the Exit Routine is written in ANS COBOL, the following must be observed in order for the exit routine to "know" that it is a called routine:


DC V(ILBDMNS0) END

0 B. Link the exit routine with this 'program', as follows: 0 INCLUDE MNS0ADDR


0 C. Now the eight-byte 'program' MNS0ADDR will immediately precede the entry-point of the exit, providing its caller with the address of the flag byte to be set when an ANS COBOL exit is to be called.

0 D. Place a 'C' in column 17 of the EXITOP card to cause the COBOL logic to be invoked.

0 3. For Univac OS/3 systems, the exit routine must be linked statically with the main program. Thereafter, it will be ignored unless an EXITOP card is present.

1

2.31 1Group 1 Software -- List Conversion System List Conversion -- System Overview

0General Information 0Alternate names for programs - Some installations may wish to assign different names to the

programs of the system, to conform to local standards, or for testing a new release, etc. While this presents no problem in the case of the EXEC-level programs, some systems also include subroutines which perform I/O functions in specialized areas. The names of these routines may also be changed, but the EXEC-level programs which invoke them must be informed of the name under which each routine is to be found. The IOMODS parameter card is provided for this purpose. All GROUP 1 EXEC-level programs will accept an IOMODS card, but it will have no effect unless the I/O subroutine is to be invoked.

0 The format of the IOMODS card is as follows: -IOMODS Parameter Card 0 CARD COLUMNS FIELD DESCRIPTION 0 01 - 06 PARAMETER KEYWORD - Must contain 'IOMODS'. 0 08 - 15 VSAM I/O ROUTINE - May contain the name

assigned to the subroutine which is delivered as 'VSIO', and which performs direct-access on VSAM Master and Work files.

0 If either a TAPEIP or DISKIP parameter card is encountered in the parameter stream (SYS004), then an additional file, SYS002, will be opened and processed as an extension of the parameter stream. The record size of this file must be 80 bytes.

0| This SYS002 auxiliary file will accomodate parameters shared | by multiple programs, if needed. This file can also serve | other purposes as required by your installation.


0General Information 0Relocation for Subroutines (old DOS operating systems): - Old DOS operating systems do not provide relocation information

in the core-image library copy of programs, so that when these programs are dynamically loaded (at a random address), their internal address constants do not contain the correct values, which will prevent the system from operating correctly. The following procedure may be used to overcome this problem.

0 1) When the exit routines are assembled, punch out an object deck.

0 2) Linkedit the object decks producing core-image modules and retain the printed listing. A following step will need to know the address at which the program is linked.

0 3) Create a tape or disk file which consists of the object decks for the subroutines, each preceded by a PROGRAM card (see below). The order of the programs in this file is not significant. (Actually, only the RLD cards from the object decks will be used, and if you wish to reduce the size of the file, you may eliminate the other cards. RLD cards have the characters 'RLD' in columns 2-4.) The PROGRAM cards are used to identify the object deck (or RLD cards) which follow, and must be punched as follows:

0 Cols. 1-8: Must contain 'PROGRAM ' 9-16: Must contain the name of the subroutine,

left-justified and padded on the right with blanks. If an alternate name is used for the subroutine, the alternate name must be entered.

17-27: Must contain ' LINKED AT ' 28-33: Must contain the address at which the

subroutine is linked, from the linkedit listing from step 2. This address must be entered as a six-digit hexadecimal value, with leading zeroes as required.

34-80: These columns are ignored. The file created must have a record size of 80, and may be blocked. A relatively small block size is recommended, since this file will take up buffer space.

0 4) When executing program MW210, assign the file created in step 3 to SYS009, and provide a TAPEI9 card in the parameter list. The programs will scan the TAPEI9 file for the relocation information necessary for proper execution of the subroutines which they require.

0 4. Under DOS and OS/3, the EXITOP routine will get control only once per block of TAPEOP. Those versions write completed

+ blocks of the output in order to be able to accommodate the Honeywell format blocks which are an option in the O/P-FILE DTF parameter card.

1Group 1 Software -- List Conversion System 3.1 Program MW210 -- Parameter Definition

0Parameter Section - This section explains in detail the function of each of the Parameter

cards. Input and Output fields are specified by non-zero numerics denoting the starting position in the Input or Output Areas. Work Areas are denoted by the names described in the System Overview. It is important to remember that Parameters are executed in a fixed order and not the order in which they are presented to the program. The Brief Explanation of Parameters Section of the System Overview lists the parameters in the order they will be executed.


0TAPExx Parameter Card - TAPExx or DISKxx cards must be used to activate each input or output

file. Following is a brief description of each of the possible files. See the System Overview section for a detailed description of the TAPExx/DISKxx card fields.

- File_Activators: + _______________ 0 IN - Input Name & Address file. 0 OC - Output Converted Name & Address file. 0 OR - Reject Tape. If this file is activated, then all rejected

records will be written to this file in the original format (except that any translates and/or Field Shifts will already have been performed).

0 OS - Output Conversion Statistics file (see SUMMARY FILE CODE cards).

0 PN - Alternative Card Punch. If this file is activated, then the Tape or Disk file defined will be used instead of the card punch, if a PUNCH KEY card is also provided. The DDname or logical assignment is SYS003 (as is the assignment for the card punch if TAPEPN is not provided).

- To accommodate old parameter card decks, the following parameters can be used to define the input and output files in place of TAPEIN and/or TAPEOC cards:

- Input_file + __________ 0 RECORD SIZE (all systems)

HEADER (DOS and OS/3 only) END OF FILEx (all systems) BANNER WORD (all systems)

0 Note: The input file is SYS010 reguardless of whether or not the + ____

TAPEIN (or DISKIN) card is present. The DTF name is TAPEIN (or DISKIN) if the TAPEIN (or DISKIN) card is present, and TAPESTD (or DISKSTD) otherwise.

- Output_File + ___________ 0 O/P-FILE DTF (DOS and OS/3 only)

SYS011 DD statement in JCL (OS only) 0 Note: The output file is SYS015 if the TAPEOC (or DISKOC) + ____

card is present, with a DTF name of TAPEOC (or DISKOC). Otherwise, it is SYS011 with a DTF name of TAPEOP (or DISKOP).


0HEADER Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'HEADER'.

This parameter is used to define label handling to DOS and OS/3 operating systems.

0 08 - 10 LABEL HANDLING OPTIONS - Must contain one of the following:

0 STD - The program assumes the input file has standard IBM header and trailers.

NO - The program assumes the input file has no labels, and processing will start with the first record.

nnn - The program will start processing after 'nnn' blocks have been skipped.

+ ______ This is to ignore non-standard labels that might appear at the beginning of each input reel; i.e., if there is one non-standard label record before data appears, then 'nnn' = '001'. Field must be numeric, right justified, and zero filled.

0 Note: Under OS the JCL will determine this condition and this card + ____

will be used as comment. Under DOS and OS/3 if no HEADER parameter is used, 'NO' is assumed.

0 If a TAPE/DISK card is present for file IN then this card is not allowed.


0END OF FILE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'END OF FILE'.

This card allows the program to recognize any one of up to three non-standard end-of-file indications.

0 12 - 12 COMPARAND NUMBER - Must contain either 1, 2, or 3 to define up to 3 comparands.

0 14 - 15 COMPARAND LENGTH - Must contain a numeric value between 01 and 10 to tell the program the number of characters each block will

+ _____ be compared against for a non-standard end-of-file.

0 17 - 26 COMPARAND VALUE - Must contain the value against which each block will be compared.

+ _____ 0 Example: END OF FILE1 04 1EOF 0 This example tells the program to check

the first four characters of each block + _____

for the value '1EOF'. 0 Default: If no END OF FILE cards are used, end-of-file will be + _______

recognized only by a tape mark or IBM standard trailers. 0 Note: If a TAPE/DISK card is present for file IN, then this card is + ____

not allowed.


0BANNER WORD Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'BANNER WORD'.

A banner word is a character or characters in the beginning of each block that is not part

+ _____ of the input record. For example: standard Honeywell tapes have a banner character (a banner word of one character) in the beginning of each data block. This adds one position to the block size, but does not increase the record size. Therefore, if a tape contained records of 80 characters in length and the blocking factor is 10 and each data block contained a banner word of 1 character in length, the block size would be 801.

0 Note: If a TAPE/DISK card is present for file IN, + ____

then this card is not permitted. 0 13 - 14 BANNER WORD LENGTH - Must contain a right justified,

zero filled, numeric value designating the length of the banner word contained in each input block.

+ _____ 0 Default: If no BANNER WORD card is used, no banner word is assumed. + _______


0BLOCK SIZE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 10 PARAMETER KEYWORD - Must contain 'BLOCK SIZE'. 0 12 - 16 BLOCK SIZE - May contain the block size of the

input data blocks. + ______

The minimum block size allowed is 00012 and the maximum block size allowed is 32760.

0 Note: This card is ignored and is printed on the parameter list + ____

for documentation purposes only; the block size is determined by the program as each block is read.

1


0RECORD SIZE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'RECORD SIZE'.

This parameter is used to define the record size of the Input file to the program.

0 This card is required for all operating systems, if the TAPE/DISK card for file IN is not used. If a TAPE/DISK card is used for file IN, this card is not permitted.

0 13 - 15 RECORD SIZE - Must contain the Record size of of the data records. The minimum value allowed is 012.

0 If the input consists of (standard IBM) variable length records, enter 'VAR' in these columns.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit number in columns 12-15.

0 68 - 71 DEVICE TYPE - (DOS and OS/3 only) May contain the input device type indicating the device to which the file is assigned. See TAPExx card for device types; the default is TAPE.

0 Variable-length_records: + _______________________ 0 DOS: If the records are blocked, then a BANNER WORD parameter which

specifies a banner word length of 4 must also be included. If the records are not blocked, no BANNER WORD is required.

0 OS: There are two options here. Either the complete DCB information must be provided on the SYS010 DD statement; or the SYS010 DD statement must specify:

0 RECFM=U,LRECL=32760,BLKSIZE=32760 0 and a BANNER WORD parameter must be entered if the records are

blocked, as noted above under DOS. 1


0O/P-FILE DTF Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'O/P-FILE DTF'.

This parameter is used to define the characteristics of the Output File to the program.

0 Note: This card is not permitted of OS operating + ____

systems. If a TAPE/DISK card is provided for file OC, this card is not permitted.

0 14 - 15 RECORDS PER BLOCK - Must contain the number of records per block That is, the blocking factor desired for the output block.


0 17 - 19 RECORD SIZE - Must contain the record size desired for the output file.


0 20 - 20 VARIABLE-LENGTH RECORD INDICATOR - If the output records are to be variable-length, then a 'V' must be entered in this column. Blocked variable-length records are assumed in this case, and columns 17-19 will be interpreted as a maximum record size, and columns 14-15 as the number of maximum-sized records which can fit in one block.

0 21 - 21 RECORD FORMAT INDICATOR - Must contain one of the following codes:

H - the output tape is to be recorded in Honeywell mode. Mode settings for Honeywell are: '70' - 7 track, 556 b.p.i. 'B0' - 7 track, 800 b.p.i.

S - the output tape is to be recorded in IBM mode, with standard labels.

N - the output tape is to be recorded in IBM mode, without labels.

0 23 - 23 BANNER CHARACTER - If column 21 contains an 'H', then this column may contain a 'B' to place a banner character in the beginning of each output block. If this column is left blank no banner character will be placed in the output blocks. If column 21 is not an 'H' this column will be ignored.


0O/P-FILE DTF Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 68 - 71 DEVICE TYPE - May contain the input device type

indicating the device to which the file is assigned. See the TAPExx card for device types; the default is TAPE.

0 Note: Under (at least some versions) DOS, an output file of + ____

blocked fixed-length records written with the O/P-FILE DTF card will sometimes not be readable by programs which use the Operating System to do the deblocking (this will occur when the last track has the maximum number of blocks, but the last block is not full).


0PUNCH KEY Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 09 PARAMETER KEYWORD - Must contain 'PUNCH KEY'.

This card will cause one summary card to be punched at end of job. This summary card will contain count information for the key and description defined in this card. See CONVERSION SUMMARY CARD LAYOUT.

0 11 - 17 KEY CODE - Must contain the 1 to 7 byte key code desired in the output punch card.

0 19 - 38 FILE DESCRIPTION - Must contain the file description desired in the output punch card.

0 Note: The Output generated by this card is used as Input to the + ____

MW211 and MW221 programs to create reports. 0 If present, then the PUNCH KEYS card is not permitted.


0PUNCH KEYS Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 10 PARAMETER KEYWORD - Must contain 'PUNCH KEYS'.

This card will cause one summary card to be punched for every unique value encountered in the Output records in the specified location.

+ ______ One Summary card containing count information will be generated for every unique value encounterd.

0 12 - 14 LOCATION OF KEY CODE - Must contain the location of the Key Code in the Output record.

0 16 - 16 KEY CODE LENGTH - Must contain the length of the key code specified in columns 12-15. This must be numeric value from 1 to 9.

0 Note: The Cards generated by this card is used as input to the + ____

MW211 program. 0 The PUNCH KEYS parameter uses the value in the output record + ______

to determine the key code. It is the users responsibility to place the key code in the output area. If counts by key code are wanted on rejected records, it is suggested that the MVAR parameter be used to move the key code to the output record, since the MVAR parameter is executed before any rejection can occur.

0 If present, then the PUNCH KEY card is not permitted.


0SUMMARY FILE CODE CONSTANT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 26 PARAMETER KEYWORD - Must contain 'SUMMARY FILE CODE

CONSTANT'. This card will cause one summary file record will be created at end of job. This summary record will contain count information for the key and description defined in this card.

0 28 - 36 KEY CODE - Must contain the key code desired in the output summary record.

0 38 - 57 FILE DESCRIPTION - May contain a description that will be placed in the summary file record.

0 Note: The record written by this card (on File OS) is used as an + ____

input to Consumer and Business Merge/Purge systems. If present, then the SUMMARY FILE CODE parameter is not permitted and FILE OS must be defined (TAPE/DISK card) and assigned.


0SUMMARY FILE CODE Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 17 PARAMETER KEYWORD - Must contain 'SUMMARY FILE

CODE'. 0 This card will cause one Summary File record to

be generated for every unique value encountered in the location specified by this card, in the Output record. These summary records will contain

+ ______ count information for each of the unique keys.

0 19 - 21 LOCATION OF KEY CODE - Must contain the location of the Key Code in the Output record.

0 23 - 23 KEY CODE LENGTH - Must contain the length of the key code specified in columns 19-21.

0 Note: The records written via this card (File OS) are used as input + ____

to Dupe-Elim systems. 0 The SUMMARY FILE CODE parameter uses the value in the Output + ______

record to determine the key code. It is important to remember to move the key code to the output area, this card will not move any data to the output area. If counts by key code are wanted on rejected records, it is suggested that the MVAR parameter be used to move the key code to the output record, since the MVAR parameter is executed before any rejection can occur.

0 If present, then the SUMMARY FILE CODE CONSTANT CARD is not permitted, and the TAPEOS/DISKOS is required.


0CONSTANT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 08 PARAMETER KEYWORD - Must contain 'CONSTANT'.

This parameter is used to define up to 20 constants to the program which can be referenced in the MOVE, FORMAT, and other parameter cards as C01, C02, ..., C20.

0 09 - 10 CONSTANT NUMBER - Must contain a numeric value between 01 and 20 inclusive. This number distinquishes the difference among the 20 possible CONSTANT parameter cards that may be used in the program.

0 12 - 46 CONSTANT VALUE - Must contain the value of the constant. No length is implied except that the maximum size of any constant is 35 positions. The length of the constant is specified when it is used by MOVE, PACK, FORMAT, or other parameters.

- Note: In some cases, it will be necessary to reference a constant + ____

which cannot be constructed from the characters available on your keyboard. Should this situation arise, the constant data can be entered as a string of hex digits as follows:

0 Place an 'X' in column 11 of the CONSTANT card. 0 Enter the hex digits beginning in column 12, and extending

up through column 59; this permits the entry of a constant of up to 25 bytes in length. The last character of the string must be a blank.

0 The number of hex digits entered must be even, and the character following the last hex digit must be a blank.

0 The valid hex digits are 0-9 and A-F, inclusive.


0CHCKPT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'CHCKPT'. 0 08 - 14 CHECKPOINT COUNT - The checkpoint parameter

card activates the IBM checkpoint facility. If this option is used, checkpoints will be taken for every 'n' input records processed. This field must contain a number which will be used as 'n'. The value must be numeric and greater than one, entered with leading zeroes as required.

0 68 - 71 (DOS only) DEVICE - May contain the device to which the checkpoint file is to be assigned. See the TAPExx card for a list of available device types. The default is 2314.

- OS_CHECKPOINT-RESTART + _____________________ 0 1. A DD-statement (DDNAME=SYS001) must be provided for the

checkpoint dataset. It must specify a physical-sequential dataset which may reside on either tape or disk.

0 2. If the DISP parameter on the SYS001 DD does not specify MOD, then:

0 A. Each checkpoint will be written over the preceding checkpoint; and, therefore:

0 B. If a checkpoint cannot be taken successfully, there will be no checkpoint available for restart until another checkpoint is successfully taken.

0 3. Restart as specified in the JCL manual.


0CHCKPT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - DOS_CHECKPOINT-RESTART + ______________________ - If checkpoint processing is being performed (i.e.,

the 'CHCKPT' parameter is present), the following additional JCL is needed:

0 // ASSGN SYS001,X'nnn' // DLBL DTFPHM,'CHECKPOINT',0010,SD // EXTENT SYS001,WORK02,1,0,20,200

0 If the job must be restarted from a checkpoint, then the following card replaces the '// EXEC' card in the run deck. No parameter cards need to be entered:

0 // RSTRT SYS001,nnnn,DTFPHM 0 ...Where 'nnnn' is the Restart or Checkpoint

number the user wishes to restart from.


0END Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 03 PARAMETER KEYWORD - Must contain 'END'. 0 This card will be treated as a comment and

processing of parameters will proceed until end of file is reached in the card reader.

0 The END parameter card is allowed to provide compatibility with parameter decks prepared in accordance with the requirements of an earlier version of this program.

1


0START AFTER Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'START AFTER'.

This parameter is used to designate the number of input records that will be bypassed until processing is initiated.

0 13 - 18 NUMBER OF RECORDS TO BYPASS - Must contain a 6-digit number to denote the number of records to be bypassed, after which processing will be initiated.

1 1Group 1 Software -- List Conversion System 3.29

Program MW210 -- Parameter Definition 0STOP AFTER Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 10 PARAMETER KEYWORD - Must contain 'STOP AFTER'.

This parameter is used to limit the number of Input records that will be processed.

0 12 - 15 NUMBER OF RECORDS TO PROCESS - Must contain a 4-digit number to denote the number of records to be processed, after which processing will be terminated as if end-of-file had been reached.


When using this this parameter in conjunction with the START AFTER parameter, the NUMBER OF RECORDS TO PROCESS must also include the number of records processed by the START AFTER.

1


0REJECT CONTROL Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 14 PARAMETER KEYWORD - Must contain 'REJECT CONTROL'.

This parameter may be used to set the limit s for the number of rejects to allow. If this limit is provided and exceeded, the program will terminate.

0 16 - 20 MAXIMUM NUMBER OF REJECTED RECORDS - May contain the number of records which are to be rejected, in thousands.

0 22 - 26 RESERVED - This field was formerly used to control the maximum number of rejected records which were to be printed. That function is now accomplished via the PRINT REJECT card.

0 28 - 30 LOCATION FOR REJECT CODE - May contain the location in the input record at which will be placed a one-byte Reject Code indicating the reason for rejection. This option is normally used in conjunction with the TAPEOR parameter card which specifies the optional output Reject Tape which will contain rejected records in the original format. The possible Reject Codes are:

0 1: COMPARE REJECT number 1 ...

9: COMPARE REJECT number 9 Z: Invalid ZIP Code C: City/State do not match ZIP Code N: Missing or invalid surname, or a Company

name when the REJECT COMPANIES parameter is present

X: Rejected by User Exit. 1


0ACCEPT APO/FPO Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 14 PARAMETER KEYWORD - Must contain 'ACCEPT APO/FPO'.

The presence of this card will expand the range of acceptable ZIP Codes to include those which are assigned to APO and FPO facilities.

0 Note: No ZIP Code validity checking is caused by this card. + ____

ZIP Code validity checking is performed automatically by each of the following parameters:

0 ISOLATE ADDRESS PARTS (CS or CSZ option) ISOLATE CITY STATE ZIP ISOLATE CITY STATE STATE LOOK UP STATE VERIFY STATE COUNTS

0 If this card is omitted, ZIP Codes assigned to APO/FPO facilities will be rejected if any of the above parameters are used.


0ACCEPT CANADA Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 13 PARAMETER KEYWORD - Must contain 'ACCEPT CANADA' 0 The presence of this card will add the Canadian

Postal Codes to the table of acceptable ZIP Codes. 0 When using this card the term State also refers

to Province, and the term ZIP Code also refers to Postal Code.

0 15 - 18 CANADIAN ONLY - May contain 'ONLY' if all U.S. ZIP Codes are to be rejected. If this field is left blank, then Canadian and U.S. ZIP Codes will be accepted.

0 If 'ONLY' is specified, then: ACCEPT APO/FPO, ACCEPT AUSTRALIA, and and STATE SELECT cards containing U.S. States, will be overridden if

+ __________ before the ACCEPT CANADA parameter; and those cards will not be permitted following the ACCEPT CANADA card.

0 Note: No Postal Code validity checking is caused by this card. + ____

Postal Code validity checking is performed automatically by each of the following parameters:

0 ISOLATE ADDRESS PARTS (CS or CSZ option) ISOLATE CITY STATE ZIP ISOLATE CITY STATE

0

STATE LOOK UP STATE VERIFY STATE COUNTS

If this card is omitted and Canadian Provinces are not marked acceptable via the STATE SELECT Parameter, then records with Canadian Postal Codes will be rejected if any of the above Parameters are used.


0ACCEPT AUSTRALIA Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 16 PARAMETER KEYWORD - Must contain 'ACCEPT AUSTRALIA' 0 The presence of this card will add the Australian

Post Codes to the table of acceptable ZIP Codes. 0 When using this card the term State also refers

to Territory, and the term ZIP Code also refers to Post Code.

0 18 - 21 AUSTRALIAN ONLY - May contain 'ONLY' if all U.S. ZIP Codes are to be rejected. If this field is left blank, then Australian and U.S. ZIP Codes will be accepted.

0 If 'ONLY' is specified, then: ACCEPT APO/FPO, ACCEPT CANADA, and and STATE SELECT cards containing U.S. States, will be overridden if

+ __________ before the ACCEPT AUSTRALIA parameter; and those cards will not be permitted following the ACCEPT AUSTRALIA card.

0 Note: No Post Code validity checking is caused by this card. + ____

Post Code validity checking is performed automatically by each of the following parameters:


0 If this card is omitted and Australian Territories are not marked acceptable via the STATE SELECT Parameter, then records with Australian Post Codes will be rejected if any of the above Parameters are used.

0 Note: When the above parameters are used for records containing + ____

Australian Post Codes, the standard Australian State/Territory abbreviations (up to three characters) will not fit in the variable STE. In this case, a pseudo-Australian abbreviation consisting of the letter 'A' and a number from one to eight is stored instead. The correct abbreviation may be moved into the output records by the use of the EXPAND AUSTRALIAN STATE parameter card.

1


0STATE SELECT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'STATE SELECT'.

The presence of this card will restrict the range of acceptable ZIP Codes to include only those states or Canadian Provinces specified.

0 14 - 15 STATE CODES - Must contain from one to eighteen 17 - 18 State or Canadian Province abbreviations, specifying . those States or Provinces which are to be deemed . acceptable. The first blank field encountered will

65 - 66 terminate processing of this card. 0 Australian States and Territories may be specified

in this card also, but the standard Australian abbreviation (two or three characters) is not used; instead, one of the following pseudo abbreviations must be supplied:

0 A1 for NSW -- New South Wales A2 for ACT -- Australian Capital Territory A3 for VIC -- Victoria A4 for QLD -- Queensland A5 for SA -- South Australia A6 for NT -- Northern Territory A7 for WA -- Western Australia A8 for TAS -- Tasmania

0 Note: If any STATE SELECT cards are present, then only those states + ____

or Provinces specified are acceptable. As many cards as are required may be entered, but no state may be specified more than once. The states may be specified in any order.

0 If STATE SELECT parameters are provided, then no STATE REJECT parameters are permitted.

0 No State or ZIP Code validity checking is caused by this card. ZIP Code validity checking is performed automatically by each of the following parameters:



0STATE REJECT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'STATE REJECT'.

The presence of this card will restrict the range of unacceptable ZIP Codes to include only those States or Canadian Provinces specified.

0 14 - 15 STATE CODES - Must contain from one to eighteen 17 - 18 State or Canadian Province abbreviations, specifying . those States or Provinces which are to be deemed . unacceptable. The first blank field encountered

65 - 66 will terminate processing of this card. 0 Australian States and Territories may be specified

in this card also, but the standard Australian abbreviation (two or three characters) is not used; instead, one of the following pseudo abbreviations must be supplied:


0 Note: If any STATE REJECT cards are present, then all States + ____

except those specified will be valid. + ______

As many cards as are required may be entered, but no state may be specifed more than once. The states may be specified in any order.

0 If STATE REJECT parameters are provided, then no STATE SELECT parameters are permitted.

0 No State or ZIP Code validity checking is caused by this card. ZIP Code validity checking is performed automatically by each of the following parameters:



0STATE REJECT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Canadian Provinces not specified in STATE REJECT cards will not + ___

be treated as valid unless an ACCEPT CANADA card is also present. 0 Similarly, Australian States not specified in STATE REJECT will

not be treated as valid unless an ACCEPT AUSTRALIA card is also present.


0ACTIVATE EXIT ROUTINE 9 - The ACTIVATE EXIT ROUTINE 9 parameter card is used to call once more

at end of job (after all records have been processed, and the control totals printed) the same routine which was called per record via the ACTIVATE EXIT ROUTINE 1 or ACTIVATE EXIT ROUTINE 2 card. The card has the same format as those cards (which see, below), and the interface to the Exit Routine is of course the same. By using an Exit Routine 9 entry as well as the per-record entries, an Exit Routine can be constructed which accumulates totals as the records are passed, and which prints them at end-of-job. Such a routine, of course, can determine which of its functions it is to perform at each invocation by examination of the ACTIVATE EXIT ROUTINE card image (the fifth parameter).

0 The return code (parameter 1) is not examined upon return from Exit Routine 9, and an Exit Routine should not attempt to use the Input (parameter 3) or Output (parameter 4) record areas when it is called at Exit Routine 9 time.

0 In order for the Exit routine 9 memory (which is to be printed, etc.) to be the same as that in which the accumulation was performed, the program is not loaded again when the '9' card is encountered. Instead

+ ___ the name specified is searched for among the loaded routines,. This (possibly 'peculiar') treatment of this card imposes the restriction that the ACTIVATE EXIT ROUTINE 9 card must follow in the parameter

+ ______ deck the corresponding ACTIVATE EXIT ROUTINE 1 or 2 card.

1


0ASCII TRANSLATE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 15 PARAMETER KEYWORD - Must contain 'ASCII TRANSLATE'. 0 If this card is present, then the entire input + ______

record will be translated from ASCII code to EBCDIC. 0 Note; This card should not be used if Packed + ____

numeric fields are in the input record. The TRANSLATE CARD parameters should be used.


0LOWER/UPPER TRANSLATE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 21 PARAMETER KEYWORD - Must contain the following

'LOWER/UPPER TRANSLATE'. 0 If this card is present, then each input record

will be translated so that lower-case characters are transformed to upper-case, and no other characters are changed.

0 This parameter should not be used if the input data contains packed decimal or binary fields. In that case the TRANSLATE CARD Parameters should be used.


0TRANSLATE CARD Parameter Card - CARD COLUMNS - 01 - 14

0 15 - 15

0

0 17 - 80

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'TRANSLATE CARD'. All data will be translated as per the Translate Table set up by the user. If no Translate Cards are present, all input data will remain unchanged. All four Translate Cards need not be used, but if one is used, the unused portion of the Translate Table will be blanks and input data having binary values for these blank positions will be converted to blanks. TRANSLATE TABLE SEGMENT IDENTIFIER - Must contain one of the following to define which segment of the Translate Table is being defined:

1 - characters 001-064 of the Translate Table 2 - characters 065-128 of the Translate Table 3 - characters 129-192 of the Translate Table 4 - characters 193-256 of the Translate Table

TRANSLATE TABLE VALUES - Must contain the character set for this segment of the Translate Table.

0 OPTIONAL 'Z' CARD: 0 01 - 14 PARAMETER KEYWORD - Must contain 'TRANSLATE CARD'.

This optional 'Z' card will instruct the program to Translate only the fields specified. This card must be used only in conjunction with the TRANSLATE CARD 1, 2, 3, or 4 and must be entered after these four cards.

0 15 - 15 'Z' OPTION DESIGNATOR - Must contain 'Z'. 0 17 - 19 LOCATION OF FIELD TO BE TRANSLATED - Must contain

24 - 26 the starting position(s) of the respective 31 - 33 field(s) in the input record to be translated. 38 - 40 If this option is to be used, the first field,

columns 17-19, must be numeric and must have a range between 001 and 999 inclusive. The first blank field encountered terminates processing of this card.

0 21 - 22 LENGTH OF FIELD TO BE TRANSLATED - Must contain 28 - 29 the corresponding lengths of the fields defined 35 - 36 in columns 17-19, etc. Must contain a non-zero 42 - 43 numeric value.

1


0MVAR Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'MVAR'.

Up to 100 MVAR parameters may be entered. For use see discussion below.

0 05 - 06 COMMENT - These columns are ignored by the program and may be used for comment.

0 08 - 10 OUTPUT POSITION - Must contain either the position in the Output Area to which data is to be moved, or a Work Area designation.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit output position in columns 7-10.

0 12 - 13 LENGTH OF MOVE - Must contain the length of the the move to perform. This value may not exceed the length of any Work Area specified in columns 8-10.

0 If necessary, this field may be extended to the left one position, to allow the entry of a 3-digit length in columns 11-13.

0 15 - 17 INPUT POSITION - Must contain the position in the Input Area from which data is to be moved if present. A Work Area designation in these columns is invalid.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit input position in columns 14-17.

0 General: For each record, based on the actual record length, the + _______

following is performed: 0 If the source field specified is entirely in the input

record, it is moved to the destination field as is. 0 If the source field is partially contained in the input

record, the portion in the input record is moved, and padded on the right with blanks to fill the destination field to the specified length.

0 If the source field is entirely beyond the input record, the destination field is filled with blanks for the specified length.

1


0FVAR Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'FVAR'.

The parameter is used to string together fields and moves the entire string to the Output Area specified. Up to five FVAR cards may be entered. See below for further discussion of this parameter.


0 08 - 10 LOCATION FOR RESULTING STRING - Must contain the starting position in the Output Area or a Work Area where the resulting formatted string will be placed.

0 If an Output location is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 7-10.

0 11 - 11 OVERFLOW OPTION - May contain an 'R' if records are to be rejected when the formatted string exceeds the length specified in columns 12-13. If this column does not contain an 'R', formatted strings which exceed the specified length will be truncated.

0 12 - 13 LENGTH OF RESULTING STRING - Must contain the length of the Area defined in columns 8-10. This must be a non-zero numeric value.

0 15 - 17 LOCATION OF FIELDS TO BE FORMATTED - Must contain 22 - 24 the starting positions of 2 to 9 fields in the Input 29 - 31 Area or Work Areas that contain the fields to be 36 - 38 formatted. The fields are formatted left to right. 43 - 45 Columns 15-17 and columns 22-24 must be entered. 50 - 52 The first blanks encountered will terminate 57 - 59 processing of this card. 64 - 66 71 - 73 If necessary, where specifying an Input location,

these fields may be extended to the left one position, allowing the entry of 4-digit positions in columns 14-17, 21-24, etc.

_________

__________

1Group 1 3.50

25 - 25 32 - 32 39 - 39

+ 46 - 46 53 - 53 60 - 60

+ 67 - 67 74 - 74

0 19 - 20 26 - 27 33 - 34 40 - 41 47 - 48 54 - 55 61 - 62 68 - 69 75 - 76

0 21 - 21 28 - 28 35 - 35 42 - 42 49 - 49 56 - 56 63 - 63 70 - 70 77 - 77

Software -- List Conversion System

0FVAR Parameter Card - CARD COLUMNS - 18 - 18

Program MW210 -- Parameter Definition

FIELD DESCRIPTION CONSTANT TREATMENT - Must contain one of the following to control the formatting of constants:

'*' - constant will not appear if the Preceding field contains all

blanks. blank- constant will not appear if the

Succeeding field contains all

blanks. See example below. LENGTH OF FIELDS TO BE FORMATTED - Must contain the corresponding lengths of the fields defined in columns 15-17, etc.

ZERO SUPRESSION - Must contain a 'Z' if suppression of leading zeros is desired in the corresponding field defined in columns 15-17, etc.

Note that this 'Z' may conflict with a 4-digit position, if needed for the following field.


0FVAR Parameter Card - CARD COLUMNS FIELD DESCRIPTION - General: Following are a number of rules and restrictions that apply to + _______

the FVAR parameters: 0 (1) FVAR parameters will be executed in the order

presented. 0 (2) The first field to be formatted must not be

a constant. 0 (3) There must be at least two fields to be

formatted. 0 (4) Two consecutive non-constant fields will

automatically have a space placed between them. 0 (5) All leading blanks of non-constant fields will

be suppressed and will not appear in the out-put string.

0 (6) No spaces will appear between constants and variables unless allowed for in defining the constant.

0 Example: FVARAD W01 35 001 25 100 10 + _______ 0 If 001 contains The address line and 100 contains

any overflow from the address line -0 If 001 contains '1002 thousand oaks place' and

100 contains 'apt. 344', the output will contain '1002 thousand oaks place apt. 344'

1


0FIELD SHIFT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'FIELD SHIFT'.

This parameter will cause the program to move fields, as a whole, in such a way that a non-blank field, if present, ends up in a known location. See General below for discussion of how parameter works.

0 13 - 15 LOCATION OF FIELDS TO SHIFT - Must contain 20 - 22 the starting postions in the Input Area or 27 - 29 Work Areas that are to participate in the 34 - 36 Field Shift. 41 - 43 48 - 50

0 17 - 18 LENGTH OF FIELDS TO SHIFT - Must contain the 24 - 25 corresponding lengths of the fields defined in 31 - 32 columns 13-15, etc. 38 - 39 45 - 46 52 - 53

0 General: This parameter operates directly on fields in the Input Area, + _______

or on Work Areas, or on a combination. It examines the fields in the order in which they are defined, and moves them so that the first non-blank field encountered ends up in the first location defined, the second non-blank field ends in the second location defined, etc. If any of the fields are blank, then the last location defined, the next-to-last location defined, etc., will be blank. If all fields defined are non-blank, or if all are blank, then none of the fields are altered.

0 Note: This parameter operates directly on fields in the Input Area. + ____

Records printed using the PRINT INPUT/REJECT parameter cards will show the record as altered by the field shift.

3.54

0

1Group 1 Software -- List Conversion System Program MW210 -- Parameter Definition

0FIELD SHIFT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: + _______

If an Input record has two possible name fields, either of which could be blank, and it is necessary that the first field always contain data, a FIELD SHIFT parameter similar to the following should be used:

0 FIELD SHIFT 001 35 036 35 0 Input-001 Input-036 Result-001 Result-036 + _________ _________ __________ __________ 0 The Trust Co. John Smith The Trust Co. John Smith 0 (blank) John Smith John Smith (blank) 0 The Trust Co. (blank) The Trust Co. (blank) 0 Note: If the lengths of the fields vary, then the shifting operation + ____

may cause longer fields to be truncated when they are moved. There must be at least two fields to shift if this card is used.


0COLLAPSE NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 13 PARAMETER KEYWORD - Must contain 'COLLAPSE NAME'.

This parameter will cause the program to collapse, remove a blank or apostrophe, from two-part surnames fields. All apostrophes will be removed. See General below for discussion of how parameter works.

0 15 - 17 LOCATION OF FIELD TO COLLAPSE - Must contain the the location in the Input Area or a Work Area that is to be collapsed.

0 19 - 20 LENGTH OF FIELD TO COLLAPSE - Must contain the length of the field that is to be collapsed.

0 General: This parameter operates directly on fields in the Input Area or on Work Areas. It examines the field and removes any apostrophes, then checks for a two-part surname at the front of the field. If a two-part surname does not start in position one of the defined field, the name will not be collapsed. All apostrophes, regardless of there postion in in the field, will be removed.


0COLLAPSE NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: + _______ 0 In this example the name field in the input record is in the

format: 0 (Surname)(space)(first name)(space)(middle initial). 0 In order for a ISOLATE FULL NAME Parameter to work correctly,

the name field must be presented in natural order. A SCAN AND SPLIT parameter can be used to reverse the name.

0 SCAN AND SPLIT 001 35 W36 35 W01 35 X ISOLATE FULL NAME W01 70

0 Without the COLLAPSE NAME parameter being used the following would result:

0 Input-001 W01 W36 N02 N04 + _________ ___ ___ ___ ___ 0 SMITH JOHN JOHN SMITH JOHN SMITH 0 O TOOLE JOHN TOOLE JOHN O TOOLE JOHN O 0 MAC DUFF J DUFF J MAC DUFF J MAC 0 With the following COLLAPSE NAME parameter being used 0 COLLAPSE NAME 001 35 0 the result would be: 0 Input-001 W01 W36 N02 N04 + _________ ___ ___ ___ ___ 0 SMITH JOHN JOHN SMITH JOHN SMITH 0 O TOOLE JOHN JOHN OTOOLE JOHN OTOOLE 0 MAC DUFF J J MACDUFF J MACDUFF


0SCAN AND SPLIT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 14 PARAMETER KEYWORD - Must contain 'SCAN AND SPLIT'.

This parameter scans for up to four different delimiters within an Input Area, splits the input information into up to four different segments based on the delimiters, and places the segments into Work Areas or back into the Input Area for additional processing. The commonly used areas provided for this purpose are S01 through S12. Up to 10 SCAN AND SPLIT parameters may be entered.

0 16 - 18 LOCATION OF FIELD TO SPLIT - Must contain the starting position in the Input Area or a Work Area containing a field with delimiter characters which separate subfields of information within the field. ** See also note below for "W" work area.

0 20 - 21 LENGTH OF FIELD TO SPLIT - Must contain the length of the field to be split. This must be a non-zero numeric value. ** See also note below for "W" work area.

0 23 - 25 STARTING POSTIONS FOR SPLIT-UP PORTIONS - These 30 - 32 columns define the starting positions of the 37 - 39 four possible split-up portions of the field 44 - 46 defined in columns 16-18. These columns must

contain numeric values between 001 and 999, the name of a Work Area, or blanks. Columns 23-25 may not be blank. ** See also note below for "W" work area.

0 27 - 28 LENGTHS FOR SPLIT-UP PORTIONS - May contain the 34 - 35 corresponding lengths of the fields defined in 41 - 42 columns 23-25, etc. Each value must be numeric 48 - 49 and in the range 01-99 or blanks. Blanks in

these columns indicates that the field is not used. When defining the length of a Work Area these lengths may not exceed the length of the Work Area. Columns 27-28 may not be blank. **See also note below for "W" work area.

0 51 - 54 DELIMITERS - May contain up to four delimiters that the user wishes to scan for in the Input Area. These may contain any set of four single characters, but if a blank is meant to be one of the delimiters, the blank value must be in card column 51. Blanks in columns 52-54 will be ignored. If the user wishes to scan for a string of characters, enter four asterisks ('****') here and enter the string for scanning purposes in columns 58-67 below.


0SCAN AND SPLIT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 56 - 56 FINAL FIELD DISPOSITION - If this column contains

an 'X', then the final field will be moved to the split-up portion in its entirety (that is without being terminated by one of the delimiters, if any is present). If this column contains any other value, then the final field will be moved only up to the next delimiter.

0 58 - 67 STRING DELIMITER - If a string of text is to be scanned for ('****') in columns 51-54), then the string of characters must be entered here starting in column 58. The last non-blank entered in this field will be considered the end of the the string. If the user wishes to specify spaces as part of the string,an apostrophe (') must be entered in column 57 and at the end of the string. Column 68 may be used for an ending apostrophe if it is necessary to scan for a 10 character character string.

0 ** Note: If the "W" Work Area is being used and the starting position is greater than 99, enter the "W" in the parameter position one position to the left of the appropriate position indicated above. If the length of the "W" Work Area is greater than 99, use the parameter position one position to the left of the indicated position above.

0 General: The input containing delimiters will be separated into up to + _______

four fields as defined in this parameter card. The separated information will be placed back into the Input Area or any Work Areas specified in order for the data to be worked on as pieces via the use of other parameters.

0 Duplication of a delimiter can result in unexpected blank fields. For example,if the name JOHN*J**JONES is scanned using * as a delimiter the following would result.

0 S01 JOHN S02 J S03 (blank) s04 JONES


0COMPARE REJECT or ACCEPT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 14 PARAMETER KEYWORD - Must contain 'COMPARE REJECT' or

'COMPARE ACCEPT'. Up to 9 sets of COMPARE REJECT and/or COMPARE ACCEPT parameters may be entered.

0 16 - 16 REJECT/ACCEPT NUMBER - Must contain a number between 1 and 9. The cards with the same number in this column must be either all COMPARE ACCEPT cards or all COMPARE REJECT cards. Such sets of similar cards (with the same number) are combined together as follows:

0 COMPARE ACCEPT - A record is rejected if it satisfies none of the specified comparisons.

+ ____ COMPARE REJECT - A record is rejected if it

satisfies all of the specified comparisons. + ___ 0 18 - 20 LOCATION OF THE COMPARAND - Must contain the

starting position of the field in the Input Area which is to be compared against the value in columns 25-39.

0 22 - 23 LENGTH OF THE COMPARAND - Must contain the length of the Area to be compared against. This must be a numeric value between 01 and 15 inclusive.

0 25 - 39 VALUE FOR COMPARISON - Must contain the value, left justified, to be compared against in the Input Area for rejection.

0 Example: COMPARE REJECT 1 027 03 ABC COMPARE ACCEPT 2 099 01 3

0 These parameters enforce the rule that the only records to be processed will be those which do have the character '3' in position 99 and do not have the string 'ABC' beginning in position 27.

0 General: Up to 200 COMPARE ACCEPT/REJECT cards may be entered, + _______

in any order. 0 Note: In order for a record to be processed by the following + ____

parameters, a record must not be rejected by any COMPARE REJECT/ACCEPT condition.

1


0LEFT JUSTIFY IP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 15 PARAMETER KEYWORD - Must contain 'LEFT JUSTIFY IP'. 0 Up to nine LEFT JUSTIFY IP cards may be

provided, to left-justify up to nine Input (or Work Area) fields.

0 16 - 16 FIELD NUMBER - Must contain a number from one to nine. The LEFT JUSTIFY IP commands will be executed in the order specified by this field number. Only one card with each number may be entered.

0 18 - 20 LOCATION OF FIELD TO BE JUSTIFIED - Must contain the starting position of the field to be left justified. This must be a non-zero numeric value.

0 22 - 23 LENGTH OF FIELD TO BE JUSTIFIED - Must contain the length of the field to be left justified. This must be a non-zero numeric value.

0 Note: The fields specified are locations within the Input area (or Work Areas). The non-blank data within each field will be shifted to the left end of the field, and vacated positions on the right will be filled with spaces.

1


0RIGHT JUSTIFY IP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 16 PARAMETER KEYWORD - Must contain 'RIGHT JUSTIFY IP'. 0 Up to nine RIGHT JUSTIFY IP cards may be

provided, to right-justify up to nine Input (or Work Area) fields.

0 17 - 17 FIELD NUMBER - Must contain a number from one to nine. The RIGHT JUSTIFY IP commands will be executed in the order specified by this field number. Only one card with each number may be entered.

0 19 - 21 LOCATION OF FIELD TO BE JUSTIFIED - Must contain the starting position of the field to be right justified. This must be a non-zero numeric value.

0 23 - 24 LENGTH OF FIELD TO BE JUSTIFIED - Must contain the length of the field to be right justified. This must be a non-zero numeric value.

0 Note: The fields specified are locations within the Input area (or Work Areas). The non-blank data within each field will be shifted to the right end of the field, and vacated positions on the left will be filled with spaces.


0EXTRACT SECOND NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 19 PARAMETER KEYWORD - Must contain 'EXTRACT SECOND

NAME'. This parameter is used to extract the second name from a name field which contains two given names, distinguished by a separator (see below) with or without a last name.

0 21 - 23 LOCATION OF THE INPUT FIELD - Must contain the location of the input name. This must be a position in the Input Area, or one of the Work Areas.

0 Note: The primary name (after extraction of the separator and second name) will be stored back into this area, in upper case.


0 25 - 26 LENGTH OF THE INPUT FIELD - Must contain the length of the input field.

0 28 - 30 LOCATION FOR EXTRACTED SECOND NAME - Must contain the location at which the extracted second name will be placed. This must be a position in the Output Area, or one of the Work Areas.


0 32 - 33 LENGTH OF THE EXTRACTED SECOND NAME - Must contain the length of the extracted second name field.

0 Note: If this length is smaller than the resulting extracted second name, the second name will be truncated. This field will be stored in upper case.

0 35 - 35 SEPARATOR - May contain a non-blank character which is to be used as the element which separates the first name from the second name, in the input field. If this column is left blank, then any of the following will be treated as a separator:

0 an ampersand (&) the word AND the word OR


0EXTRACT SECOND NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Notes: This parameter should not be used when the input field + _____

may contain company names (which may contain separators). See the final example below.

0 If a separator (character) is specified in column 35, then the words AND and OR will not be treated as separators.

0 General: This parameter operates on a single input field as follows: + _______ 0 The input field is examined for a separator. If none is found, the

original field is left unchanged, except for upper-case conversion, and the output field is set to blanks.

0 If the string following the separator is 'MS', 'MRS' or 'MME', then the input field is left unchanged, except for upper-case conversion, and the output field is set to blanks.

0 Otherwise: The separator is removed The word following the separator is placed in the Output field,

and removed from the input string If a single character follows the word following the separator,

it is appended to the Output field, preceded by a space, and removed from the input string

If any characters remain in the Input field, they are placed immediately after the characters which preceded the separator, after the insertion of a single space.

- Examples: EXTRACT SECOND NAME S11 35 S12 35 + ________ 0 Input_(S11)____________ + _______________________ 0 JOHN AND MARY

JOHN & MARY SMITH JOHN P & MARY O BRIEN JOHN P & MARY O'BRIEN JOHN JOHN AND AND MARY AND MARY JONES JOHN SMITH & MARY JOHN SMITH & MARY JONES A & D MARKETING

Output_(S11)_____________ Second_(S12)__ _________________________ ______________ JOHN MARY JOHN SMITH MARY JOHN P BRIEN MARY O JOHN P O'BRIEN MARY JOHN (blank) JOHN (blank) MARY (blank) MARY JONES (blank) JOHN SMITH MARY JOHN SMITH JONES MARY A MARKETING D


0ACTIVATE EXIT ROUTINE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 21 PARAMETER KEYWORD - Must contain 'ACTIVATE EXIT

ROUTINE'. There are two exit routines that the users can utilize for their own coding. See MW210 OVERVIEW to determine the timing of each of the Exits.

0 23 - 23 EXIT ROUTINE NUMBER - Must contain '1', '2', or '9' to specify the exit wanted.

0 25 - 32 PHASE NAME - May contain the phase name of the exit routine. If a phase name is entered, the routine will be dynamically loaded at execution time. If no phase name is entered, the exit routine(s) must be linked with the main module before execution.

0 34 - 34 COBOL INDICATOR (DOS) - Must contain 'C' if the exit is written in ANS COBOL under DOS.

0 35 - 80 USER DEFINED PARAMETER AREA - May be used by the user to indicate processing variations to the exit routine. The entire card image is passed to the exit routine as parameter 5.

0 Note: See ACTIVATE EXIT ROUTINE 9 for discussion of end of job + ____

processing with an Exit Routine.


0ACTIVATE EXIT ROUTINE Parameter Card - PARAMETERS FOR THE EXITS 0 Parameter 1: A 4 byte binary field in which to place

a return code as follows: 0 0 -- normal return (accept the record)

4 -- skip record (do not output the record and do not print the record)

8 -- reject record (do not output the record, but print the record)

Other -- treated same as zero. 0 Parameter 2: USERDATA area as follows: 0 Reserved 4 bytes

Reserved 4 bytes 14-byte COMMENT area for user reject 14 bytes HSE - Isolated House Number 10 bytes DIR - Isolated Pre directional 2 bytes STR - Isolated Street Name 35 bytes PST - Isolated Post directional 2 bytes DSG - Apartment type designator 4 bytes APT - Apartment designator number 8 bytes CTY - Isolated City Name 35 bytes STE - Isolated State Abbreviation 2 bytes ZIP - Isolated ZIP Code 11 bytes C01-C20 - constant storage 35 bytes each A01-A06 - 6 Address Parts 50 bytes each Reserved 11 bytes N01-N06 - 6 Name Elements 35 bytes each S01-S12 - Scan/Split areas 50 bytes each W01-W256 - 256 Work locations 1 byte each

0 Parameter 3: Input Record Area 0 Parameter 4: Output Record Area 0 Parameter 5: The 80-byte ACTIVATE EXIT ROUTINE card image.


0ACTIVATE EXIT ROUTINE Parameter Card - The following example illustrates the required

linkage: 0 EXIT1 START

USING *,15 STM 14,12,12(13) LM 8,12,0(1)

* R8 NOW CONTAINS THE ADDRESS OF A WORD * TO PLACE THE RETURN CODE, R9 CONTAINS * THE ADDRESS OF THE USERDATA AREA, R10 * CONTAINS THE ADDRESS OF THE INPUT AREA, * R11 CONTAINS THE ADDRESS OF THE OUTPUT AREA, * AND R12 CONTAINS THE ADDRESS OF THE ACTIVATE * EXIT ROUTINE CARD IMAGE.

.

. (enter user coding here)

.

. LM 14,12,12(13) BR 14 END EXIT1

- The same is done for Exit Routine 2 except EXIT2 is specified instead of EXIT1. Neither user routine will be activated unless the corresponding parameter card is present.

- Entry Conditions: 0 R13 contains address of a usable 18-word save area.

Its first two words may not be altered. 0 R14 contains return address 0 R15 contains entry-point address of exit 0 R1 contains the address of five contiguous addresses,

one for each of the parameters described above.


0ACTIVATE EXIT ROUTINE Parameter Card - ANS COBOL Exits under DOS + _________________________ 0 In order for an ANS COBOL exit under DOS to "know" that it is

a called program, the following must be observed: 0 1. For exits which are to be link-edited with MW210,

the exit name field of the parameter card must be left blank, and 'C' placed in the COBOL indicator column. When this is the case, MW210 will call routine ILBDSET0 before the first call to the exit.

0 2. For exits to be dynamically loaded, the exit name must be provided in the parameter card, and 'C' must be placed in the COBOL indicator column. In addition, the following steps must be taken:


DC V(ILBDMNS0) END

0 B. Link the exit routine with this program as follows: 0 INCLUDE MNS0ADDR


0 C. Now the eight-byte "routine" MNS0ADDR will immediately precede the entry-point of the exit, providing MW210 with the address of the flag byte to be set.


0ISOLATE FULL NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 17 PARAMETER KEYWORD - Must contain 'ISOLATE FULL

NAME'. This parameter is used to isolate a full name in to up to six separate fields (see below).

0 19 - 21 LOCATION OF THE FULL NAME FIELD - Must contain the starting position of the full name field in the Input Area. This must be a non-zero numeric value or the name of one of the Work Areas.

0 23 - 24 LENGTH OF THE FULL NAME FIELD - Must contain the length of the full name field. This must be a non-zero numeric value.

0 26 - 26 APOSTROPHIZED NAMES TREATMENT - Must contain one of the following codes to indicate the way in which apostrophized names (such as O'BRIEN and D'AMATO) will be left in the N04 area:

0 blank - leave as O BRIEN 'A' - leave as O'BRIEN 'S' - leave as OBRIEN

0 Note: All of the following formats will be treated as apostrophized names - O'BRIEN, OBRIEN, and O BRIEN.

0 28 - 28 COMPANY NAME ANALYSIS - Must contain one of the following codes to control whether or not the name is to be analyzed to determine if it is a 'Company Name' (see below). The codes are:

0 Blank: Examine the name to see if it is a Company Name (See cols. 32-39).

'C': Treat all names as Company Names. 'N': Do not treat any names (except those

defined by the company indicator option of the COMPANY NAME parameter, if present) as Company Names.

0 30 - 30 PROFESSIONAL SUFFIXES TREATMENT - Must contain one of the following to define the treatment of professional suffixes:

0 blank - look for professional suffixes (See cols. 41-48).

X - do not look for professional suffixes.

In


0ISOLATE FULL NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 32 - 39 NAME OF CORPORATE TABLE - May contain the name of

the table of Corporate-indicative words. If blank, 'MW210TC' will be assumed. If column 28 is blank, the (specified or default) table will be dynamically loaded.

0 41 - 48 NAME OF PROFESSIONAL SUFFIXES TABLE - May contain the name of the table of professional suffixes. If blank, 'MW210TP' will be assumed. If column 30 is blank, the (specified or default) table will be dynamically loaded.

0 50 - 50 TREATMENT OF HYPHENS - May contain a 'Y' if hyphens are to be maintained. If column 50 does not contain a 'Y', hyphens will be treated as blanks.

0 Full Name: A field which contains a person's title of respect, given name, middle name, surname, maturity title, and professional title. The only one of these six which is required is the surname. Any field which contains all or any combination of these six elements in the order given can be handled by this parameter. The program will ignore any special characters that might separate any of these elements within the field. Note that this routine will not move these elements to the Output Area. It merely separates the six elements into Work Areas called N01 through N06. order to move these elements to the Output Area, the MOVE, FORMAT, or TITLE TABLE cards must be used.

0 WORK AREA ELEMENT NAME EXAMPLE MAX. LENGTH 0 N01 Title of Respect MR 35

N02 Given Name JOHN 35 N03 Middle Name JOSEPH 35 N04 Surname JONES 35 N05 Maturity Name JR 35 N06 Professional Title MD 35


0ISOLATE FULL NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Company Name handling: 0 When a "Company Name" is recognized, the entire name

is strung out through N04, N02, and N03, in that order, and an asterisk ('*') is placed in N01. Then, if Companies and proper names are mixed, the companies will sort in the expected place (that is, 'IBM CORP' will sort amongst the I names, not the C names, when sorted by last name).

0 The lengths of the segment in each of the Nnn areas is determined by the COMPANY NAME parameter, or if it is omitted, the following defaults are used:

0 N04: 16 characters N02: 10 characters N03: 1 character

1


0COMPANY NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'COMPANY NAME'.

This parameter is used to alter the program in the following ways: (1) Change the lengths of the the N04, N02, and N03

areas for company names. (2) Define and recognize a company indicator field

which already exists in the records. 0 14 15 LENGTH OF N04 - May contain the altered length

of that portion of the company name that is put into the 'N04' area up to 35 bytes.

0 17 - 18 LENGTH OF N02 - May contain the altered length of that portion of the company name that is put into the 'N02' area up to 35 bytes.

0 20 - 21 LENGTH OF N03 - May contain the altered length of that portion of the company name that is put into the 'N03' area up to 35 bytes.

0 To further identify companies as an extension of the ISOLATE FULL NAME routine, the following may be entered:

0 23 - 25 LOCATION OF COMPANY INDICATOR - May contain the starting position of a company indicator field that exists in the Input Area. The company indicator may be some identifying character(s) that identifies that record as a company to the ISOLATE FULL NAME routine.

27 - 28 LENGTH OF COMPANY INDICATOR - May contain the length of the company indicator field. This

0

must be a numberic between 01 and 10. 0 30 - 39 VALUE OF COMPANY INDICATOR - May contain the value

of the company indicator. 0 Note: If a company indicator comparison is specified in columns 23-39 + ____

then it will be effective even if the 'No Companies' option is specified in column 28 of the ISOLATE FULL NAME parameter.


0REJECT COMPANIES Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 16 PARAMETER KEYWORD - Must contain 'REJECT COMPANIES'.

If this parameter is used and a company name is recognized the record will be rejected. See below for further discussion on company name recognition.

0 18 - 21 BYPASS INDICATOR - If these columns contain 'SKIP', then company names will be skipped (not written to the output file, but not printed either) instead of rejected.

0 General: If this card is present, all records with companies recognized + _______

in the ISOLATE FULL NAME routine or with companies recognized by a company indicator specified in the COMPANY NAME parameter will be rejected or skipped. See the ISOLATE FULL NAME parameter discussion of how company names are handled and recognized.


0ISOLATE PART NAME Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 17 PARAMETER KEYWORD - Must contain 'ISOLATE PART

NAME'. This parameter is used to isolate a part name in to up to four separate fields (see below).

0 19 - 21 LOCATION OF THE PART NAME - Must contain the starting position of the 'Part Name' field in the Input Area. This must be a non-zero numeric value or one of the Work Areas.

0 23 - 24 LENGTH OF THE PART NAME - Must contain the length of the 'Part Name' field. This must be a non-zero numeric value.

0 Part Name: A field which contains a person's title of respect, given name, middle name, and maturity title. None or any of these elements need to be present, however, for this routine to work. The only requirement is that these four elements of the name be in the order given. This routine works in the same manner as the 'ISOLATE FULL NAME' parameter and does not move the four elements to the Output Area, but to the N01, N02, N03, and N05 Areas respectively.

0 WORK AREA ELEMENT NAME EXAMPLE MAX. LENGTH 0 N01 Title of Respect DR 35

N02 Given Name JOHN 35 N03 Middle Name JOSEPH 35 N05 Maturity Name JR 35

1


0GENDER CODE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'GENDER CODE'.

This parameter will cause the program to place a code in the records denoting the gender determined by analysis of a first name field.

0 13 - 15 LOCATION FOR GENDER CODE - Must contain the location at which will be placed a one-byte code denoting the gender code. This may be any numeric value between 001 and 999, and represents a location in the Output Area or a Work Area.

0 17 - 19 LOCATION OF FIRST NAME - Must contain the starting position in the Input Area or a Work Area that contains the first name field to be analyzed.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit output position or expanded work area in columns 16-19.

0 21 - 22 LENGTH OF THE FIRST NAME - Must contain the length of the first name field.

0 24 - 30 GENDER CODES - May contain the codes desired in the output location for various situations, as follows:

0 24 - 24 Default is 'A'. For an ambiguous first name, such 'Terry'.

0 25 - 25 Default is 'B'. For a first name which starts with a blank.

0 26 - 26 Default is 'C'. For a company name (will never occur unless the ISOLATE FULL NAME parameter is also entered).

0 27 - 27 Default is 'F'. For a female-gender first name. 0 28 - 28 Default is 'I'. For a first name which is only

an initial. 0 29 - 29 Default is 'M'. For a male-gender first name. 0 30 - 30 Default is 'U'. For an unrecognizable first name. 0 32 - 39 GENDER TABLE NAME - May contain the name of the

gender table. If blank, 'MW210TG' will be assumed. The gender table will be dynamically loaded whenever this card is present.

1


0ISOLATE ADDRESS PARTS Parameter Card - CARD COLUMNS - 01 - 21

0

0

23 - 25 30 - 32 37 - 39 44 - 46 51 - 53 58 - 60 27 - 28 34 - 35 41 - 42 48 - 49 55 - 56 62 - 63

0 65 - 67

0

0

0

0

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'ISOLATE ADDRESS PARTS'. This parameter causes the program to take from 2 to 6 Address Lines that are filled, starting with the first field, then the second field, and so on, and isolates them into Work Areas called A01, A02, A03, A04, A05, and A06. The program takes the last Address Line and places it in Area A06, the next to last Address Line in A05, and so on. STARTING LOCATIONS - Must contain the starting locations of 2 to 6 Address lines in the Input Area or a Work Area. Columns 23-32 may not be blank.

LENGTHS OF ADDRESS LINES - Must contain the corresponding lengths of the fields defined in columns 23-25, etc. This must be a numeric value between 05 and 50. Blanks in these columns indicate that the field is not used. Columns 27-35 may not be blank. When defining the length of a Work Area these lengths may not exceed the length of the Work Area. LAST LINE TREATMENT INDICATOR - Must contain one of the following codes to direct the program how to handle the last Address Line:

CSZ - If the last field, which is always isolated into Area A06, contains City, State and ZIP Code.

CS - If the last field contains City and State only.

CTY - If the last field contains the City only.

NCS - If the last field contains no City or State information.


0ISOLATE ADDRESS PARTS Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Note: The 'CSZ' option isolates the City, State,

and ZIP Code into separate fields called CTY, STE, and ZIP respectively. The 'CS ' option isolates the City and State only into separate fields called CTY and STE. The word 'ZIP' must be entered in cols. 69-71, and the starting position of the ZIP Code location in the Input Area must be punched in cols. 73-75.

0 The 'CTY' option isolates only the City into a field called CTY.

0 The 'NCS' option performs no further isolation.

0 69 - 71 CS ZIP OPTION - If columns 65-67 contain 'CS ', then 'ZIP' must be entered in these columns.

0 73 - 75 CS ZIP LOCATION - If columns 65-67 contain 'CS ', then the location of the ZIP Code in the Input Area must be entered in these columns. The field at the location specified may contain a 5-digit ZIP Code, a 3-byte packed ZIP Code, a 5-byte packed 9-digit ZIP code, a 6 byte packed 11-digit ZIP code, a 6 character Postal Code, or a 7-character Postal Code. The routine will recognize any of these formats.

0 Australian 4-digit Post Codes will also be recognized, provided that they are followed by a space. If this presents a problem for a particular record format, you must move the Post Code to a Work Area using the MVAR parameter card, and refer to the Work Area here.

0 77 - 78 CS ZIP LENGTH - If columns 65-67 contain 'CS ', then the length of the ZIP Code specified by columns 73-75 must be entered in these columns.


0ISOLATE ADDRESS PARTS Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: If an address list has a possible three (3) address lines + _______

a 'c/o Address Line', a Street Address Line, and a City-State-ZIP Line, then:

0 If all three address line are present then, 0 A06 will contain the last non-blank

address line (the City-State-ZIP line). 0 A05 will contain the street address or

the most significant of the two address lines between A05 and A04.

0 Note: A04 and A05 will contain the indicated data regardless_of_the_order of the lines in the

+ _______________________ input record.

0 Note: In order to put any of the Isolated Address Parts to the Output + ____

Area, the use of the 'MOVE' or 'FORMAT' cards is necessary. 0 If 'CSZ, 'CS ', or 'CTY is entered in columns 65-67, the routine

will automatically select the most significant address line from Areas A03, A04, and A05 and swap it into area A05.

0 If 'NCS' is entered in columns 65-67, the routine will select the most significant address from areas A04, A05, and A06 and swap it into area A06.

0 For Australian addresses, a pseudo State abbreviation is placed in the STE Work Area. See the EXPAND AUSTRALIAN STATE parameter card for details.

0 See 'ISOLATE CITY STATE ZIP' parameter definition for possible reasons for record rejection.

1


0ISOLATE CITY STATE ZIP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 22 PARAMETER KEYWORD - Must contain 'ISOLATE CITY

STATE ZIP'. This routine will isolate the City, State, and ZIP Code in one field into separate areas called CTY, STE, and ZIP respectively.

0 24 - 26 LOCATION OF THE CITY-STATE-ZIP FIELD - Must contain the starting position of the City-State-ZIP field and must be a non-zero numeric or a Work Area.

0 28 - 29 LENGTH OF THE CITY-STATE-ZIP FIELD - Must contain the length of the City-State-ZIP field. This must be a non-zero numeric field.

0 Note: In order to put any of the isolated address parts to the + ____

Output Area, the use of the 'MOVE' or 'FORMAT' parameters is necessary.

0 For Australian addresses, a pseudo State abbreviation is placed in the STE Work Area. See the EXPAND AUSTRALIAN STATE parameter card for details.

0 If the input record consists of city and zip code no state present and the city name consists of two words then the second word of the city name is interpreted as the state.

0 Rejects: Records will be rejected during processing if one of the + _______

following occurs: (1) A legitimate ZIP Code, Canadian Postal Code, or

Australian Post Code is not found. (2) The STATE is not a value recognizable according

to the ZIP Code. (3) No CITY is present. (4) The ZIP Code is not acceptable as specified by

the following Parameter Cards: 0 ACCEPT APO/FPO

ACCEPT CANADA ACCEPT AUSTRALIA STATE REJECT STATE SELECT


0ISOLATE CITY STATE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 18 PARAMETER KEYWORD - Must contain 'ISOLATE CITY

STATE'. This parameter will isolate the CITY and State from one field into separate areas called CTY and STE. The ZIP Code must be in a fixed location and will be placed in an area called ZIP.

0 20 - 22 LOCATION OF THE CITY-STATE FIELD - Must contain the starting position of the City-State field, and must be a non-zero numeric value or a Work Area.

0 24 - 25 LENGTH OF THE CITY-STATE-FIELD - Must contain the length of the City-State field. This must be a non-zero numeric value.

0 27 - 29 Must contain 'ZIP'. 0 31 - 33 ZIP LOCATION - Must contain the starting position

of the ZIP Code in the Input Area or a Work Area. The field at the location specified may contain a 5-digit ZIP Code, a 3-byte packed ZIP Code, a 5-byte packed 9-digit ZIP code, a 6-byte packed 11-digit ZIP code, a 6 character postal code, or or a 7-character Postal Code. The routine will recognize any of these formats.


0 35 - 36 ZIP LENGTH - Must contain the length of the ZIP CODE field specified by columns 31-33.


Area, the use of the 'MOVE' or 'FORMAT' cards is necessary. 0 For Australian addresses, a pseudo State abbreviation is placed

in the STE Work Area. See the EXPAND AUSTRALIAN STATE parameter card for details.

0 See 'ISOLATE CITY STATE ZIP' parameter definition for possible reasons for record rejection.

0 If the input record consists of city and zip code no state present and the city name consists of two words then the second word of the city name is interpretted as the state.


0STATE LOOK UP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 13 PARAMETER KEYWORD - Must contain 'STATE LOOK UP'.

This parameter determines the state by the 3-digit ZIP Code in the record and moves the standard State abbreviation to the Area STE and the ZIP Code to the Work Area ZIP.

0 15 - 17 LOCATION OF ZIP CODE OR POSTAL CODE - Must contain the starting position of the ZIP Code or Postal Code in the Input Area or a Work Area. This may define the location of a 5-digit or 3-digit ZIP code, a 5-byte packed 9-digit ZIP code, a 6-byte packed 11-digit ZIP code, a 6-character Postal Code, or a 7-character Postal Code. The routine will recognize any of these formats.



Area, the use of the 'MOVE' or 'FORMAT' cards is necessary. 0 See 'ISOLATE CITY STATE ZIP' parameter definition for possible

reasons for record rejection. 0 A few 3-digit ZIP Codes are primarily in one state but have a

few (5-digit) ZIP Codes which are in a neighboring state. For these cases, the State abbreviation for the predominant state will be stored.

1


0STREET SPLIT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'STREET SPLIT'. 0 This parameter splits up a street address line

into its elements: house number, directional, street name, post directional, apartment designator, and apartment number. When the street address has been split into the elements as mentioned, the data will be placed in Areas called HSE, DIR, STR, PST, DSG, and APT respectively.

0 The data stored in STR (which is what remains after removal of the house number, leading directional, apartment designator, and apartment number, if present) will be stored with multiple embedded blanks collapsed to a single space. If apartment data is found, any data found after the apartment data will be dropped.

0 14 - 16 LOCATION OF THE STREET ADDRESS LINE - Must contain the starting position of the street address line in the Input Area or a Work Area.


0 18 - 19 LENGTH OF THE STREET ADDRESS LINE - Must contain the length of the street address line to be split. This must be a non-zero numeric value.


0STREET SPLIT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Notes: The street address line to be split must be in a fixed location + _____

to use this parameter. If the street address is not always in a fixed location the ISOLATE ADDRESS PARTS parameter card can be used, and the A05 or A06 (if using the NCS option) Work Area can be used.

0 The Street Split routine is not designed to correct an address line that is badly formed. It is designed to isolate the house

number, leading directional, street, post directional, apartment designator and apartment number of a well formed address.

0 If the Street Split routine notices the street address to be a post office box, then both HSE and DIR will be blank and STR contain first 'BX ' followed by the box number and any other information in the address line. If the Street Split routine notices the street address to be a Rural Route address, then again HSE and DIR will be blank, and STR will contain 'RR ' followed by the rural route number and any other information in the address line. Thus, the STR field (if placed on the output records) can be used as a sortation field.

0 For records with house numbers the house number will be right justified and padded on the left with blanks.

0 In order to put HSE, DIR, STR, DSG, or APT area to the Output Area, the use of the 'MOVE' or 'FORMAT' cards is necessary.


0TITLE TABLE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 11 PARAMETER KEYWORD - Must contain 'TITLE TABLE'.

These parameters convert titles or title codes to one form from another. Each card represents one set of values for the table. Up to 100 TITLE TABLE cards are allowed. Counts of matches against table entries will be printed in the Control Totals.

0 13 - 15 LOCATION FOR CONVERTED TITLE - Must contain the location in the Output Area or a Work Area where the converted title or title code is to be placed.


0 17 - 18 LENGTH FOR CONVERTED TITLE - Must contain the length of the Area defined in columns 13-15. This must be a numeric value between 01 and 12 inclusive.

0 20 - 31 VALUE OF CONVERTED TITLE - Must contain the value to be placed in the Area defined in columns 13-15. This value should be left justified.

0 Note: The last card must have 12 asterisks (*) in columns 40-51 and is the default card. For the last card these columns (20-31) will contain the default converted title or title code.

0 33 - 35 LOCATION OF ORIGINAL TITLE - Must contain the location in the Input Area or a Work Area where the original title or title code resides.


0 37 - 38 LENGTH OF ORIGINAL TITLE - Must contain the length of the Area defined in columns 33-35. This must be numeric value between 01 and 12 inclusive.


0TITLE TABLE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 40 - 51 VALUE OF ORIGINAL TITLE - Must contain the

value of the original title or title code. This value should be left justified.

0 Note: The last card must have 12 asterisks (*) in these columns (40-51) and is the default card. For the last card columns 20-31 will contain the default converted title or title code.

0 Note: If the Output Area is the Work Area 'N01', and 'N01' is not + ____

blank, the 'N01' Area will not be changed. Values placed in columns 13-15, 17-18, 33-35, and 37-38, need only be placed in the first TITLE TABLE card and will be ignored in all other TITLE TABLE cards. If an error is encountered in a TITLE TABLE card the remaining TITLE TABLE cards are not processed and the message NO ENDING TITLE TABLE CARD will be printed.


0CVTB Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'CVTB'.

This parameter is used to convert numeric character data from a specified location into binary at another specified location.


0 08 - 10 LOCATION FOR BINARY DATA - Must contain the starting position in the Output Area or a Work Area where the binary data will be placed.


0 12 - 13 LENGTH OF BINARY DATA - Must contain the length of the Area defined in columns 8-10. This must be a numeric value between 01 and 04 inclusive.

0 15 - 17 LOCATION OF DATA TO CONVERT - Must contain the starting position in the Input Area or a Work Area where the data to be converted resides.


0 19 - 20 LENGTH OF DATA TO CONVERT - Must contain the length of the Area defined in columns 15-17. This must be a numeric value between 01 and 15 inclusive.

0 Note: The CVTB parameters will be executed in the order presented. + ____

Up to 12 CVTB parameter cards may be entered. 1


0PACK Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'PACK'.

This parameter is used to Pack data from a specified location into another specified location.


0 08 - 10 LOCATION FOR PACKED DATA - Must contain the starting position in the Output Area or a Work Area where the packed data will be placed.


0 12 - 13 LENGTH OF PACKED DATA - Must contain the length of the Area defined in columns 8-10. This must be a numeric value between 01 and 15 inclusive.

0 15 - 17 LOCATION OF DATA TO PACK - Must contain the starting position in the Input Area or a Work Area where the data to be packed resides.


0 19 - 20 LENGTH OF DATA TO PACK - Must contain the length of the Area defined in columns 15-17. This must be a numeric value between 01 and 15 inclusive.

0 Note: The PACK parameters will be executed in the order presented. + ____

Up to 40 PACK parameter cards may be entered. 1


0CVTD Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'CVTD'.

This parameter is used to convert binary data from a given location to packed data at another specified location.


0 08 - 10 LOCATION FOR PACKED DATA - Must contain the starting position in the Output Area or a Work Area where the packed data will be placed.


0 12 - 13 LENGTH OF PACKED DATA - Must contain the length of the Area defined in columns 8-10. This must be a numeric value between 01 and 15 inclusive.

0 15 - 17 LOCATION OF DATA TO Convert- Must contain the starting position in the Input Area or a Work Area where the data to be converted resides.


0 19 - 20 LENGTH OF DATA TO CONVERT - Must contain the length of the Area defined in columns 15-17. This must be a numeric value between 01 and 04 inclusive.

0 Note: Up to 12 CVTD parameter cards may be entered. + ____

The CVTD parameters will be executed in the order presented. 1


0UNPK Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'UNPK'.

This parameter is used to unpack data from a specified location into another specified location.


0 08 - 10 LOCATION FOR UNPACKED DATA - Must contain the starting position in the Output Area or a Work Area where the unpacked data will be placed.


0 12 - 13 LENGTH OF UNPACKED DATA - Must contain the length of the Area defined in columns 8-10. This must be a numeric value between 01 and 15 inclusive.

0 15 - 17 LOCATION OF DATA TO UNPACK - Must contain the starting position in the Input Area or a Work Area where the data to be unpacked resides.


0 19 - 20 LENGTH OF DATA TO UNPACK - Must contain the length of the Area defined in columns 15-17. This must be a numeric value between 01 and 08 inclusive.

0 22 - 22 NUMERIC ZONE - If this column contains a 'Z', then the zone for the rightmost character will be set to hex 'F', to form a numeric character. If this column is blank, then the sign bits of the packed number will be used as the zone of rightmost character, and that character therefore might not be numeric.


0UNPK Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: UNPK W01 07 123 04 Z + _______

.

.

. MOVE01 001 02 W02

0 The first instruction unpacks the data in positions 123-126 of the Input Area into the Work Area W01-W07 surpressing the zone in position W07. The second instruction moves the Work Area W02-W03 into the Output Area positions 001-002.

0 Note: Up to 40 UNPK parameter cards may be entered. + ____

The UNPK parameters will be executed in the order presented.


0MOVE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 04 PARAMETER KEYWORD - Must contain 'MOVE'.

This parameter card is used to move data from the Input Area or the Work Areas to the Output Area or Work Areas.


0 08 - 10 OUTPUT POSITION - Must contain the position in the Output Area or a Work Area where data is to be moved.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit position in columns 7-10.

0 12 - 13 LENGTH OF MOVE - Must contain the length of the the move to perform. If a Work Area is specified in columns 8-10, then the length of the move not exceed the size of the Work Area.

0 If necessary, this field may be extended to the left one position, to allow the entry of a 3-digit length in columns 11-13.

0 15 - 17 INPUT POSITION - Must contain the position in the Input Area or a Work Area from which data is to be moved.

0 If necessary, this field may be extended to the left one position, allowing the entry of a 4-digit position in columns 14-17.


0MOVE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 80 - 80 CONDITIONAL EXECUTION - Must contain one of the

following codes to place conditions on the MOVE parameter execution:

0 C - execute only if a company name is recognized.

N - execute only if a company name is not recognized.

+ ___ If any other value, execution of the MOVE parameter is unconditional.

0 Note: A Company name is recognized when the first position of the N01 Work Area contains an asterisk (*), and a non-company is recognized when that position contains any other value. The ISOLATE FULL NAME parameter will mark the N01 Work Area when a Company name is detected. If the ISOLATE FULL NAME routine is not used, then the user must set the N01 Work Area appropriately, if the restrictions imposed by column 80 are to be effective.

0 Note: Up to 50 MOVE parameters may be entered. + ____

MOVE parameters will be executed in the order presented.


0EXPAND POSTAL CODE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 18 PARAMETER KEYWORD - Must be 'EXPAND POSTAL CODE'. 0 The EXPAND POSTAL CODE parameter constructs a

printable (suitable for use on a mailing label) form of the ZIP Code or Canadian Postal Code in a specified Output or Work Area location, based on the contents of the ZIP field. The length of the output area must be specified as either 7 or 10. Canadian Postal Codes will be stored left-justified in this area with a space between the FSA and the LDU. U.S. ZIP Codes will be stored left-justified; if the field length is 10 and ZIP contains a nine-digit ZIP Code, the 5-digit ZIP will be followed by a hyphen and the ZIP+4 add-on.

0 No verification of the postal code is performed

+ __ ____________ by this instruction.

0 20 - 22 OUTPUT LOCATION - Must specify a position in the Output area or a Work Area. The printable form of the postal code will be stored here.

0 24 - 25 LENGTH OF OUTPUT - Must contain either '07' or '10', specifying the length of the output area.


0EXPAND AUSTRALIAN STATE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 23 PARAMETER KEYWORD - Must contain the string

'EXPAND AUSTRALIAN STATE'. 0 The EXPAND AUSTRALIAN STATE parameter transforms

the two-character state abbreviation in the Work Area STE to three-character printable form as follows:

0 If the two-character value is not one of the pseudo Australian State abbreviations (A1-A8), then it is moved to the output location and followed by a space. For pseudo Australian State abbreviations, the Australian standard abbreviation is stored in the output location, left justified.

0 25 - 27 OUTPUT LOCATION - Must specify a position in the Output area, or a Work Area. The implied length of the output field is three characters.

0 Note: The pseudo Australian State abbreviations are:



0TABLE LOOKUP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'TABLE LOOKUP'.

This parameter is used to define up to nine tables for lookup purposes. The tables will be searched and the resulting value will be placed in the Output Area or Work Area specified. Counts of matches against table entries will be printed in the Control Totals.

0 14 - 14 TABLE NUMBER - Must contain a number from 1 to 9 to identify which of the nine separate tables is being defined.

0 16 - 18 LOCATION FOR RESULT - Must contain the location in the Output Area or a Work Area where the result of the lookup will be placed.

0 If an Output Area is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 15-18.

0 20 - 21 LENGTH OF RESULT - Must contain the length of the Area defined in columns 16-18. This must be a numeric value between 01 and 20.

0 23 - 25 LOCATION OF SEARCH ARGUMENT - Must contain the location in the Input Area or a Work Area where the argument for the search resides.

0 If an Input Area is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 22-25.

0 27 - 28 LENGTH OF SEARCH ARGUMENT - Must contain the length of the Area defined in columns 23-25. This must be a numeric value between 01 and 20.

0 30 - 49 TABLE COMPARAND - Must contain a value that the search argument will be compared against in the table.

0 51 - 70 SEARCH RESULT IN TABLE - Must contain a value which will be placed in the Area defined in columns 16-18 when the search argument matches the table comparand defined in columns 30-49.


0TABLE LOOKUP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - General: Up to nine tables may be defined, containing no more + _______

than 900 entries in total. Table 1 must be completed before Table 2 is started, and so forth. For each table, columns 16-28 are ignored in all but the first parameter card for that table.

0 Example: TABLE LOOKUP 1 N01 12 101 01 1 MR. + _______

TABLE LOOKUP 1 2 MRS. TABLE LOOKUP 1 3 REV. TABLE LOOKUP 1 4 MR. AND MRS. TABLE LOOKUP 1 5 DR. TABLE LOOKUP 2 N05 12 102 01 2 SR. TABLE LOOKUP 2 3 JR. TABLE LOOKUP 2 4 III

0 Table 1 is used to convert Title codes to the correct titles of respect. If the value in position 101 of the Input Area is '1', then 'MR.' will be moved to the N01 Work Area. If the value in position 101 of the Input Area is '2', then 'MRS.' will be moved to the N01 Work Area, etc.

0 Table 2 is used to convert Suffix codes to the correct Maturity suffix. If the value in position 102 of the Input Area is '2', then 'SR.' will be moved to the N05 Work Area, etc.

0 Note: If the search argument does not match any of the comparands + ____

in the tables, then no data will be moved to the result location. Accordingly, if a default value is desired, it should be moved to the result location by a MOVE, PACK, or UNPK parameter. Then if a match is found, the table result will overlay the default value, otherwise the result location will remain unchanged.


0RANGE LOOKUP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'RANGE LOOKUP'.

This parameter is used to define ranges for lookup purposes. The ranges will be searched and the resulting value will be placed in the Output Area or Work Area specified. Counts of matches against table entries will be printed in the Control Totals.

0 14 - 16 LOCATION FOR RESULT - Must contain the location in the Output Area or a Work Area where the result of the lookup will be placed.

0 If an Output Area is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 13-16.

0 18 - 19 LENGTH OF RESULT - Must contain the length of the Area defined in columns 14-16. This must be a numeric value between 01 and 10.

0 21 - 23 LOCATION OF SEARCH ARGUMENT - Must contain the location in the Input Area or a Work Area where the argument for the search resides.

0 If an Input Area is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 20-23.

0 25 - 26 LENGTH OF SEARCH ARGUMENT - Must contain the length of the Area defined in columns 21-23. This must be a numeric value between 01 and 10.

0 28 - 37 LOW RANGE COMPARAND - Must contain a value that the search argument will be compared against in the table to define the low end of the range.

0 39 - 48 HIGH RANGE COMPARAND - Must contain a value that the search argument will be compared against in the table to define the high end of the range.

0 50 - 59 SEARCH RESULT IN RANGE - Must contain a value which will be placed in the Area defined in columns 14-16 when the search argument falls with in the ranges defined in columns 28-48.

0 General: Up to 100 ranges may be defined. + _______


0RANGE LOOKUP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: RANGE LOOKUP 100 01 N04 01 A F 1 + _______

RANGE LOOKUP 100 01 N04 01 G L 2 RANGE LOOKUP 100 01 N04 01 M R 3 RANGE LOOKUP 100 01 N04 01 S Z 4

0 The above range lookup could be used to place a code in the output record in postion 100 which represent which quarter of the alphabet the surname falls in.

0 Note: If the search argument does not fall within any of the ranges + ____

in the tables, then no data will be moved to the result location. Accordingly, if a default value is desired, it should be moved to the result location by a MOVE, PACK, or UNPK parameter. Then if a match is found, the table result will overlay the default value, otherwise the result location will remain unchanged.

0 Only 1 RANGE LOOKUP argument is allowed. The location in the first RANGE LOOKUP parameter will be used for all ranges.


0FORMAT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'FORMAT'.

The parameter is used to string together fields and moves the entire string to the Output Area specified. Up to five FORMAT cards may be entered. See below for further discussion of this parameter.


0 10 - 12 LOCATION FOR RESULTING STRING - Must contain the starting position in the Output Area or a Work Area where the resulting formatted string will be placed.

0 If an Output location is specified, this field may be extended to the left one position, if necessary, to allow the entry of a 4-digit position in columns 9-12.

0 13 - 13 OVERFLOW OPTION - May contain an 'R' if records are to be rejected when the formatted string exceeds the length specified in columns 14-15. If this column does not contain an 'R', formatted strings which exceed the specified length will be truncated.

0 14 - 15 LENGTH OF RESULTING STRING - Must contain the length of the Area defined in columns 10-12. This must be a non-zero numeric value.

0 17 - 19 LOCATION OF FIELDS TO BE FORMATTED - Must contain 24 - 26 the starting positions of 2 to 9 fields in the Input 31 - 33 Area or Work Areas that contain the fields to be 38 - 40 formatted. The fields are formatted left to right. 45 - 47 Columns 17-19 and columns 24-26 must be entered. 52 - 54 The first blanks encountered will terminate 59 - 61 processing of this card. 66 - 68 73 - 75 If necessary, where specifying an Input location,

these fields may be extended to the left one position, allowing the entry of 4-digit positions in columns 16-19, 23-26, etc.


0FORMAT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 20 - 20 CONSTANT TREATMENT - Must contain one of the

27 - 27 following to control the formatting of constants: 34 - 34 '*' - constant will not appear if the 41 - 41 Preceding field contains all

+ _________ 48 - 48 blanks. 55 - 55 blank- constant will not appear if the 62 - 62 Succeeding field contains all

+ __________ 69 - 69 blanks. 76 - 76 See example below.

0 21 - 22 LENGTH OF FIELDS TO BE FORMATTED - Must contain 28 - 29 the corresponding lengths of the fields defined 35 - 36 in columns 17-19, etc. 42 - 43 49 - 50 56 - 57 63 - 64 70 - 71 77 - 78

0 23 - 23 ZERO SUPRESSION - Must contain a 'Z' if suppression 30 - 30 of leading zeros is desired in the corresponding 37 - 37 field defined in columns 17-19, etc. 44 - 44 51 - 51 Note that this 'Z' may conflict with a 4-digit 58 - 58 position, if needed for the following field. 65 - 65 72 - 72 79 - 79

0 Note: To format 2 fields without space between 'MOVE' the first field + ____

to a constant work area and then 'FORMAT' the constant work area with the second field:

Example Field1 'AB___' Field2 '100' Result 'AB100'


0FORMAT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 80 - 80 CONDITIONAL EXECUTION - Must contain one of the

following codes to place conditions on the FORMAT parameter execution:

0 C - execute only if a company name is recognized.

N - execute only if a company name is not recognized.

+ ___ If any other value, execution of the FORMAT parameter is unconditional.

0 Note: A Company name is recognized when the first position of the N01 Work Area contains an asterisk (*), and a non-company is recognized when that position contains any other value. The ISOLATE FULL NAME parameter will mark the N01 Work Area when a Company name is detected. If the ISOLATE FULL NAME routine is not used, then the user must set the N01 Work Area appropriately, if the restrictions imposed by column 80 are to be effective.

0 General: Following are a number of rules and restrictions that apply to + _______

the FORMAT parameters: 0 (1) FORMAT parameters will be executed in the order

presented. 0 (2) The first field to be formatted must not be

a constant. 0 (3) There must be at least two fields to be

formatted. 0 (4) Two consecutive non-constant fields will

automatically have a space placed between them. 0 (5) All leading blanks of non-constant fields will

be suppressed and will not appear in the out-put string.

0 (6) No spaces will appear between constants and variables unless allowed for in defining the constant.


0FORMAT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - Example: FORMAT01 017 25 N04 15 C01 02 N05 04 C02*01 + _______

CONSTANT01 , CONSTANT02 .

0 If N04 contains SMITH and N05 contains JR -the output will contain 'SMITH, JR.'

0 If N04 contains SMITH and N05 contains blanks -the output will contain 'SMITH'.


0EXPAND STREET ADDRESS Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 21 PARAMETER KEYWORD - Must contain 'EXPAND STREET

ADDRESS'. This parameter causes the program to look for certain abbreviations at the end of the street address line and spell them out.

0 23 - 25 LOCATION OF STREET ADDRESS LINE TO BE EXPANDED -Must contain the starting position in the Output Area where the street address line to be expanded exists. This must be a non-zero numeric value.

0 27 - 28 LENGTH OF STREET ADDRESS LINE TO BE EXPANDED -Must contain the length of the field defined in columns 23-25. This must be a non-zero numeric value.

0 General: For a complete definition of the abbreviation conversions, + _______

see the source listing for tables labeled: STREETBL, POBTBLB, and RRTBL.

0 Up to five EXPAND STREET ADDRESS cards are permitted; they will be executed in the order presented.

0 During the EXPAND STREET ADDRESS process, multiple embedded blanks will be collapsed to a single space. Note however that collapsing only occurs if an abbreviation has been expanded. For example:

0 123 MAIN STREET would not be expanded or collapsed But 123 MAIN ST would be expanded and collapsed giving 123 MAIN STREET.

0 If there is not enough room for the expansion in the output, the address will be left as is, it will not be truncated.

1


0LEFT JUSTIFY OP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 15 PARAMETER KEYWORD - Must contain 'LEFT JUSTIFY OP'. 0 Up to nine LEFT JUSTIFY OP cards may be

provided, to left-justify up to nine Output fields (Work Areas are not permitted).

0 16 - 16 FIELD NUMBER - Must contain a number from one to nine. The LEFT JUSTIFY OP commands will be executed in the order specified by this field number. Only one card with each number may be entered.

0 18 - 20 LOCATION OF FIELD TO BE JUSTIFIED - Must contain the starting position of the field to be left justified. This must be a non-zero numeric value.

0 22 - 23 LENGTH OF FIELD TO BE JUSTIFIED - Must contain the length of the field to be left justified. This must be a non-zero numeric value.

0 Note: The fields specified are locations within the Output area + ____ ______

(or Work Areas). The non-blank data within each field will be shifted to the left end of the field, and vacated positions on the right will be filled with spaces.

1


0CENTER Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'CENTER'. 0 The CENTER card is used to center data in an

Output field. Up to ten CENTER parameter cards may be supplied to operate on different fields.

0 08 - 10 LOCATION OF DATA - Must contain the location in the Output Area which contains the data to be centered. Note that a Work Area may not be specified.

0 12 - 13 LENGTH OF DATA - Must contain the length of the area containing the data to be centered.

0 Note: The Output field specified will be replaced + ____

by an equivalent field in which the non-blank data is centered.

1


0RIGHT JUSTIFY OP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 16 PARAMETER KEYWORD - Must contain 'RIGHT JUSTIFY OP'. 0 Up to nine RIGHT JUSTIFY OP cards may be

provided, to right-justify up to nine Output fields (Work Areas are not permitted).

0 17 - 17 FIELD NUMBER - Must contain a number from one to nine. The RIGHT JUSTIFY OP commands will be executed in the order specified by this field number. Only one card with each number may be entered.

0 19 - 21 LOCATION OF FIELD TO BE JUSTIFIED - Must contain the starting position of the field to be right justified. This must be a non-zero numeric value.

0 23 - 24 LENGTH OF FIELD TO BE JUSTIFIED - Must contain the length of the field to be right justified. This must be a non-zero numeric value.

0 Note: The fields specified are locations within the Output area + ____ ______

(or Work Areas). The non-blank data within each field will be shifted to the right end of the field, and vacated positions on the left will be filled with spaces.

1


0ZIP SEQUENCE CHECK Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 18 PARAMETER KEYWORD - Must contain 'ZIP SEQUENCE

CHECK'. This card causes a sequence check operation to be preformed on the Work Area called ZIP.

0 20 - 23 OUT-OF-SEQUENCE TREATMENT - If these columns contain 'STOP', and an out-of-sequence condition is detected on the Input file, end-of-file will be taken immediately. If this field contains any other value, then an out-of-sequence condition will be noted on the control totals print, but will not stop the conversion process.

0 Note: The Work Area ZIP is automatically filled by each of the following parameters: ISOLATE ADDRESS PARTS, ISOLATE CITY STATE, and STATE LOOK UP. If none of these operations is specified, then a MOVE or UNPK operation must be specified which will fill ZIP with the proper value.


0ZIP RANGE Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 09 PARAMETER KEYWORD - Must contain 'ZIP RANGE'. 0 This parameter causes a range check operation

to be performed on the Work Area called ZIP. 0 11 - 15 LOWEST ZIP CODE - Must contain the lowest

ZIP Code which is to be accepted. 0 17 - 21 HIGHEST ZIP CODE - Must contain the highest

ZIP Code which is to be accepted. 0 23 - 26 OUT-OF-RANGE TREATMENT - If these columns

contain 'STOP', then a ZIP Code higher than the value specified in columns 17-21 will be treated the same as an end-of-file on the Input File. If this field contains any other value, then the entire Input file will be processed, and ZIP Codes higher than the value in columns 17-21 will be skipped. In all cases, ZIP Codes lower than the value in columns 11-15 will be skipped.

0 Note: The Work Area ZIP is automatically filled by each of the following parameters: ISOLATE ADDRESS PARTS, ISOLATE CITY STATE, and STATE LOOK UP. If none of these operations is specified, then a MOVE or UNPK operation must be specified which will fill ZIP with the proper value.

0 Only 1 ZIP RANGE may be entered.


0ZIP CODE REJECT Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 15 PARAMETER KEYWORD - Must contain 'ZIP CODE REJECT'. 0 This parameter card causes the Work Area called

ZIP to be compared against the values from the ZIP CODE REJECT parameter cards, for each name-and-address record. If an equal table entry is detected, the record is treated as a ZIP Code Reject.

0 17 - 22 ZIP CODES TO REJECT - May contain up to eight 24 - 29 ZIP Codes or Postal Codes in each card. The 31 - 36 comparison used is dependent upon the form of 38 - 43 the ZIP Code or Postal Code, as follows: 45 - 50 52 - 57 If the last three characters of the table 59 - 64 entry are blank, then the first three characters 66 - 71 are compared. Otherwise,

0 If the table entry begins with a numeric, then the first five characters are compared (for U.S. ZIP Codes).

0 Otherwise, all six characters are compared (for Canadian Postal Codes).

- Notes: Up to 200 ZIP Codes may be entered, on any number of + _____

cards. 0 The first field of each card is accepted as is; after

the first field, then a blank field will terminate the processing of the card.

0 The Work Area ZIP is automatically filled by each of the following parameters: ISOLATE ADDRESS PARTS, ISOLATE CITY STATE, and STATE LOOK UP. If none of these operations is specified, then a MOVE or UNPK operation must be specified which will fill ZIP with the proper value.

1


0SELZIP Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'SELZIP'. 0 08 - 18 ZIP CODE RANGES - Must contain the low 5-digit

20 - 30 ZIP code, a blank, and the high 5 digit ZIP code 32 - 42 that define a range of ZIP Codes to be compared. 44 - 54 If SELZIP cards are encountered, then each 56 - 66 OUTPUT record, before written, is compared to the

resulting table of "acceptable" ZIP Codes. If a match is found, the record is processed. Otherwise, the record is dropped and processing continues with the next input record.

0 General: One or more SELZIP cards may be used to create an output + _______

file consisting of multiple dis-contigous ranges of ZIP codes. Note that the use of SELZIP has no effect on the number of records read from the input file. If it is desirable to have processing stop after the highest selected ZIP code, then the ZIP CODE RANGE card should be used in conjunction with the SELZIP card(s).

0 Up to 100 Zip code ranges may be specified in any number of SELZIP cards.


0STATE VERIFY Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'STATE VERIFY'.

This parameter causes the ZIP Work Area to be checked against the specified state abbreviation.

0 14 - 16 LOCATION OF STATE ABBREVIATION - Must contain the location in the Output Area or a Work Area which contains the two-character USPS standard State abbreviation.

0 Note: If the Work Area ZIP does not contain a valid ZIP Code, + ____

or if it does not agree with the value in the location specified in columns 14-16, then the record will be rejected with a reason code of CITY/STATE.

0 The Work Area ZIP is automatically filled by each of the following parameters: ISOLATE ADDRESS PARTS, ISOLATE CITY STATE, and STATE LOOK UP. If none of these operations is specified, then a MOVE or UNPK operation must be specified which will fill ZIP with the proper value.

0 A few 3-digit ZIP Codes are primarily in one state but have a few (5-digit) ZIP Codes which are in a neighboring state. For these cases, either state will be accepted as correct.


0STATE COUNTS Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 12 PARAMETER KEYWORD - Must contain 'STATE COUNTS'.

This parameter cause state counts to be produced for the Output File.

0 14 - 16 LOCATION OF ZIP CODE - Must contain the location in the Output Area, or a Work Area, which contains the ZIP Code which is to be used to determine the State.

0 Note: If this parameter is omitted, no state counts will be produced. + ____


0SEQUNO Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'SEQUNO'.

This parameter causes a sequence number to be placed in the Output Area. This card defines to the program a starting number, the format, and a limit for the sequence number being generated.

0 08 - 10 LOCATION OF SEQUENCE NUMBER - Must contain the location in the Output Area where the seqence number is to be placed.

0 Note: If necessary this field may be extended one position to the left, allowing the entry of a four-digit position in columns 7-10.

0 12 - 12 LENGTH OF SEQUENCE NUMBER - Must contain the length of the sequence number being generated. This must be a numeric value between 1 and 9 (1 and 5 if packed).

0 14 - 14 FORMAT DEFINITION - Must contain 'P' if a packed sequence number is desired, or a 'C' if a character sequence number is desired.

0 16 - 24 LIMIT - May contain a number defining the limit that the sequence number may reach. This must be a numeric value between 00000002 and 999999999. When this number is reached, sequencing will start over again with 1, or the value defined in columns 26-34.

0 26 - 34 STARTING NUMBER - May contain a number defining the starting sequence number. This must be a numeric value between 000000002 and 999999999 or blanks. If these columns are blank sequencing will start with the number one. If columns 16-24 contain a limit, resequencing will occur with the value defined in these columns.

0 36 - 36 COUNT ALL RECORDS PROCESSED - May contain an 'A' if all records read are to increment the sequence number. If not an 'A', only non-rejected records will be used to increment the sequence number.

0 Note: if 'A' is used non-serial sequence numbers will appear on the output records.


0SEQUNO Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 38 - 40 LOCATION OF SEQUENCE NUMBER IN REJECTED RECORDS -

May contain the location in the Rejected records where the sequence number is to be placed. This field may only be used if column 36 contains an 'A'.


0 42 - 42 LENGTH OF SEQUENCE NUMBER IN REJECTED RECORDS -Must contain the length of the sequence number if columns 38-40 are used. This must be a numeric value between 1 and 9 (1 and 5 for packed numbers).


0SPLIT FUNCTION - The SPLIT function is used to assign key codes to the Output records

based on a percentages defined in the SPLIT cards. Three parameter card types are used to achieve this function. Below are descriptions of the three card types.

- CARD COLUMNS FIELD DESCRIPTION 0 SPLIT LOCATION Parameter Card: 0 01 - 14 PARAMETER KEYWORD - Must contain 'SPLIT

LOCATION'. 0 16 - 18 LOCATION OF KEY CODE - Must contain the

location in the Output Area for the assigned key codes. This must be a non-zero numeric value.


0 20 - 21 LENGTH OF KEY CODE - Must contain the length of the key codes assigned. This must be a numeric value between 01 and 10.

0 SPLIT KEY CODE Parameter Card: 0 01 - 14 PARAMETER KEYWORD - Must contain 'SPLIT

KEY CODE'. 0 16 - 16 KEY CODE REFERENCE LETTER - Must contain an

alpha value between 'A' and 'O' inclusive. These are reference letters to the Key Codes.

0 18 - 27 KEY CODE VALUE - Must contain the key code to be assigned to the Output Records. This can be any value left justified up to ten characters in length, but must correspond to the length specified in the SPLIT LOCATION Card.

0 Note: Up to 15 SPLIT KEY CODE parameters may

be used.


0SPLIT FUNCTION - CARD COLUMNS FIELD DESCRIPTION - SPLIT DEFINITION Parameter Card: 0 01 - 16 PARAMETER KEYWORD - Must contain 'SPLIT

DEFINITION'. 0 18 - 80 SPLIT CONTROLS - Must contain the definition

used to control the split of the Output File. The reference letters defined in the SPLIT KEY CODE parameter are used to represent the key codes to be assigned. The order and number of times the reference letters appear represent the split to be performed. An asterisk (*) must be entered in the column following the last reference letter. There can be a maximum of 2 SPLIT DEFINITION parameters. See example below to further illustrate the SPLIT FUNCTION.

0 Example: Let us say that we wish to assign 50% of the Output File + _______

key code 1111, 25% of the file key code 2222, and 25% of the file key code 3333. The location in the Output record is position 73. The following parameters would be used:

0 SPLIT LOCATION 073 04 SPLIT KEY CODE A 1111 SPLIT KEY CODE B 2222 SPLIT KEY CODE C 3333 SPLIT DEFINITION ABAC*

0 The first record would be marked 1111 the second record would be marked 2222, the third record would be marked 1111, the fourth record would be marked 3333, the fifth record would be marked 1111, etc.


0ADJUST RDW Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 10 PARAMETER KEYWORD - Must contain 'ADJUST RDW'.

This parameter causes the program to adjust the the RDW (Record Descriptor Word) up (when the record is lengthened), down (when the record is shortened), or set to a specific value when creating variable-length records that are all the same size, or when using the TRUNCATION option (see below).

0 12 - 12 ADJUSTMENT OPERATION - Must contain one of the following codes to indicate the operation to be performed on the RDW of the Output variable-length record:

0 '+' - indicates the value in columns 13-15 is to be added to an existing RDW.

'-' - indicates the value in columns 13-15 is to be subtracted from an existing RDW.

'S' - indicates that the output RDW is to be set to the value in columns 13-15.

0 13 - 15 VALUE OF ADJUSTMENT - Must contain the value to be applied to the RDW, as specified above. This must be a non-zero numeric value.

0 17 - 17 TRUNCATION OPTION - If this column contains a 'T', then after the RDW has been set or adjusted, the record will be shortened to remove trailing blanks.

1


0PRINT Parameter Cards - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'PRINT '. 0 Three different PRINT cards are available,

allowing complete control of the printing of Rejected records, of Input records which are successfully converted, and of Output records.

0 07 - 12 PRINT TYPE - Must contain one of the following: 0 REJECT - controls printing of Rejected records.

INPUTS - controls printing of successfully converted Input records.

OUTPUT - controls printing of Output records. 0 Note that if no PRINT REJECT card is present, no

rejected records will be printed; if no PRINT INPUT card is present, no input records will be printed; and similarly for PRINT OUTPUT.

0 14 - 14 DATA SELECTION - This column controls the amount of data from each record which is to be printed. It must contain one of the following codes:

0 blank - Print the entire record 'L' - Print as much data as will fit in one

line, starting in a specified position 'O' - Print the entire record, except offset

by a specified number of positions 'T' - Print the record from position one,

truncated to a specified length. 0 For L, O, and T the specified number must be

entered in columns 15-17. 0 15 - 17 DATA SELECTION NUMBER - These columns are ignored

if column 14 is blank. Otherwise, the number specifying the quantity associated with column 14 must be entered here.


0PRINT Parameter Cards - CARD COLUMNS FIELD DESCRIPTION - 19 - 19 PRINT FORMAT - This column controls the format in

which the records will be displayed. It must contain one of the following codes:

0 'C' - character format, 100 characters per line 'D' - same as 'C', except that characters other

than the numbers, upper- and lower-case letters, and common punctuation characters will be displayed as a period.

'V' - vertical character/hex format, 100 characters occupying each four lines

'W' - same as 'V', except that on the "character" line, characters other than the numbers, upper- and lower-case characters, and common punctuation characters will be displayed as a period.

'X' - horizontal hex/character format, 32 characters per line (similar to a memory dump)

'F' - user-controlled formatting as specified in PRINT FIELDS cards. This option is only available in the PRINT OUTPUT card.

0 21 - 25 PRINT LIMIT - May contain the maximum number of records of the specified type which are to be printed. If omitted, no limit will be placed on the number of records printed under control of this card.


one column to the left, allowing the entry of a six-digit number in columns 20-25.

0 27 - 31 NUMBER OF RECORDS TO SKIP - May contain a number of records to skip before printing begins. If omitted, printing will start with the first record.


one column to the left, allowing the entry of a six-digit number in columns 26-31.


0PRINT Parameter Cards - CARD COLUMNS FIELD DESCRIPTION - 33 - 35 Nth RECORD PRINT - May contain a number n which + _

will reduce the number of records printed to every nth record (starting after the skip amount is

+ ___ satisfied, if one is specified). If entered, the number must be at least two. If omitted, every record will be printed.


one column to the left, allowing the entry of a four-digit number in columns 32-35.

0 Note: For all formats (column 19) except 'F', a descriptive stub + ____

will be printed to the left of the record proper. The stub will contain the type of record (INPUT, OUTPUT, or REJECT reason), the record number, and the position of the first character displayed.

0 The record number is as follows: 0 For rejected records, the number of the record in the input + _____

file For input and output records, the number of the record in the

output file. This ensures that an INPUT and OUTPUT record + ______

printed with the same number will represent the same data. 0 For PRINT REJECT and PRINT INPUT, the record displayed is that

from the input buffer. Note that it may not be exactly the same as the record on the input file, due to the action of TRANSLATE, SCAN AND SPLIT, or FIELD SHIFT parameter cards, or to a user exit routine.

1


0PRINT FIELDS Parameter Cards - CARD COLUMNS - 01 - 12 0

0 14 - 14

0

0 16 - 25 27 - 36 38 - 47 49 - 58 60 - 69

0 16 - 18, etc.

0 20 - 21, etc.

0 23 - 25, etc.

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'PRINT FIELDS'. One or more PRINT FIELDS cards may be used to fully specify the formatting of up to nine lines for the printing of output records. LINE NUMBER - Must contain the number of the line which is to be filled by the remaining fields in the card. If only line 1 is specified (in any number of cards), then the output records will be printed single-spaced. If any card specifies a line other than one, then the highest line number will determine the number of lines printed, and the first line for each record will be double-spaced. FIELD MOVE SPECIFICATIONS - Up to five fields may be specified in each card. The first blank field specification in each card terminates processing for that card. Each field specification is composed as follows: PRINT POSITION - Must contain a position in the specified print line, from 001 to 132. FIELD LENGTH - Must contain the length of the field to be printed. FIELD LOCATION - Must contain a position in the output record, or one of the work areas. If necessary, this field may be extended one position to the left, allowing the specification of a four-digit output location in columns 22-25, etc.

0 Note: If the PRINT OUTPUT card, column 19, is 'F', then at least + ____

one PRINT FIELDS card must be present. Otherwise, no PRINT FIELDS cards are permitted.

1

4.1 1Group 1 Software -- List Conversion System Program MW210 -- Tables

- The conversion program uses several tables in the ISOLATE FULL NAME and ISOLATE PART NAME routines to determine the elements of the name. For a complete list of these tables see the source program as follows:

0 Table Definition Program Label 0 TITLES: The titles in this table TITLES

are used to match against the first word(s) in a FULL/PART NAME field in order to extract the title from the field if one exists.

0 PREFIXES: The prefixes in this NAM2LT & NAM3LT table are used to recognize two part surnames as in the name MC DONALD.

0 MATURITY SUFFIXES: The suffixes in MATRTB this table are used to extract suffixes from the surname like JR, SR, etc.

- The EXPAND STREET ADDRESS routine uses three tables to change abbreviations in the street address line to spelled out versions as follows:

0 0

0

Table Definition STREET TABLE: The entries here expand street endings like AV to AVENUE. P.O. BOX TABLE: The entries here

Program Label STREETBL

POBTBLB expand entries like BX and BOX to P. O. BOX.

0 RURAL ROUTE TABLE: The entries here RRTBL expand entries like RR to RURAL ROUTE.

1Group 1 Software -- List Conversion System 4.2 Program MW210 -- Tables

- STATE/SECTIONAL CENTER TABLE - This is the State/Sectional Center Table used in the

"ISOLATE CITY STATE ZIP" and the "ISOLATE CITY STATE" routines. In both routines after finding the proper range of sectional centers a particular record represents, the number of elements for that particular state is determined by the code in the table. If the code is 1, then one ele-ment in the City-State or City-State-ZIP field is bypassed from right to left and the remaining element(s) in the field is considered the city. If the code is 2, then one element in the field is bypassed. If this element equals the 2 position state code or the 2 position state code with periods imbedded, the remaining element(s) in the field is considered the city. If the first element bypassed is not equal to either of the state codes, then one more element is bypassed and the remaining element(s) is considered the city. If, at the point where the city is determined, the city is non-existent, the record will be rejected. The state is taken from the table for its corresponding Sectional Center. The first character of the state in the input record is also verified against the first in the table. If these characters are not equal, the record will be rejected.

0 See the source program for the entries in the table, which is called STABLE.

0 The Conversion program is delivered with three separate table modules. These modules are for Professional suffixes, Corporation names, and for Gender coding. Unless otherwise specified the names of the modules that are loaded are MW210TP, MW210TC, and MW210TG respectivly. Additional information can be found in the Parameter Section under 'GENDER CODE' and 'ISOLATE FULL NAME' parameters.

4.3 1Group 1 Software -- List Conversion System Program MW210 -- Tables

- REASONS FOR RECORD REJECTION - ROUTINE REASON COMMENT 0 ISOLATE FULL NAME No surname recognized SURNAME 0 Company name instead of SURNAME

individual name 0 ISOLATE ADDRESS PARTS No 5 digit numeric ZIP INVALID ZIP

(CS and CSZ options) No city element found CITY-STATE

0 State elements do not CITY-STATE match with ZIP Code

0 ISOLATE CITY STATE No 5 digit numeric ZIP INVALID ZIP ZIP Code found

0 No city element found CITY-STATE

0 State elements do not CITY-STATE match with ZIP Code

0 ISOLATE CITY STATE ZIP Code not numeric INVALID ZIP 0 No city element found CITY-STATE 0 State elements do not CITY-STATE

match with ZIP Code 0 STATE VERIFY ZIP Code does not match INVALID ZIP

State elements 0 State elements do not CITY-STATE

match with ZIP Code 0 STATE LOOK-UP ZIP Code does not match INVALID ZIP

State elements 0 STATE COUNTS ZIP Code does not match INVALID ZIP

State elements 0 COMPARE REJECT User specified by REJECT n

parameter 0 USER REJECT User specified in exit USER REJECT 1

1Group 1 Software -- List Conversion System 5.1 Program MW210 -- Operating Instructions

- PROGRAM FUNCTION: List Conversion PROGRAM NAME: MW210 0 SYS NR/ DEVICE I/O

DDNAME ADDRESS FILE DESCRIPTION/LABEL RET. FILE ID DISPOSITION + ______________________________________________________________________

T A SYS010 I Name & Address Records TAPEIN (TAPEIN pres) P SYS010 I Name & Address Records TAPESTD (no TAPEIN) E SYS015 O Converted N/A Records TAPEOC (TAPEOC pres)

o SYS011 O Converted N/A Records TAPEOP (no TAPEOC) r

(See File_Activators for a discussion of the above files) + _______________

D I SYS012 (opt) S K SYS016 (opt)

U N SYS001 (opt) I SYS002 (opt) T SYS003 (opt) S

0 SYS NR/ DDNAME

+

O Rejected N/A Records

O Conversion Statistics

I/O Checkpoint File I Auxiliary Parameter file O Summary Card

DESCRIPTION OF CARD

TAPEOR

TAPEOS

DTFPHM TAPEIP TAPEPN

DISPOSITION ______________________________________________________________________

0 R SYS004 Parameter Cards P SYS003 Summary Card (if no TAPEPN) MW211

0 SYS NR/ FORM CARRIAGE DDNAME DESCRIPTION OF REPORT NUMBER TAPE DISPOSITION

+ ______________________________________________________________________ P R SYS005 Parameter List, Std. Std. I Rejected Records, N PRINTed Records, T Control Totals E R

0 MESSAGE RESPONSE + ______________________________________________________________________

C O N S O L E


- PROGRAM FUNCTION: List Conversion PROGRAM NAME: MW210 - ADDITIONAL OPERATING INSTRUCTIONS: 0 Mount files as indicated on the preceding page, put proper

forms in the printer, put JCL and parameters in the card reader and execute the program.

0 The parameters are read, edited and listed on the printer. If errors are detected in the parameters, the parameters with errors are flagged, the tape files will not be opened and the program will be terminated. If the parameters are error-free, the tape file(s) will be opened and processing will continue until end of file is reached.

0 If the ZIP RANGE parameter card is entered with a "start and stop ZIP Code", processing will be performed within the inclusive range of the two ZIP Codes entered in the parameter card.


- SAMPLE OS JCL - //MW210 EXEC PGM=MW210

//SYS005 DD SYSOUT=A,DCB=(RECFM=FBA,BLKSIZE=133,LRECL=133) //SYSUDUMP DD SYSOUT=A //SYS010 DD DSN=TAPEIN,UNIT=TAPE,VOL=SER=TAPEIN, // DISP=OLD,LABEL=(2,BLP), // DCB=(DSORG=PS,RECFM=FB,LRECL=rrrr,BLKSIZE=bbbbb) //SYS012 DD DSN=TAPEOR,UNIT=TAPE,VOL=(,,,30),DISP=(,CATLG), // DCB=(DSORG=PS,RECFM=FB,LRECL=rrrr,BLKSIZE=bbbbb) //SYS015 DD DSN=TAPEOC,UNIT=TAPE,VOL=(,,,30),DISP=(,CATLG), // DCB=(DSORG=PS,RECFM=FB,LRECL=rrrr,BLKSIZE=bbbbb) //SYS003 DD SYSOUT=B,DCB=(RECFM=FB,LRECL=80,BLKSIZE=80) //SYS004 DD *

5.4 1Group 1 Software -- List Conversion System Program MW210 -- Operating Instructions

- SAMPLE DOS JCL - // JOB MW210

// TLBL TAPEIN,'tape name' // TLBL TAPEOC,'tape name' // TLBL TAPEOR,'tape name' // ASSGN SYS010,X'180' (Input Tape) // ASSGN SYS015,X'181' (Output Tape) // ASSGN SYS012,X'182' (Reject Tape) // ASSGN SYS004,X'00C' (Card Reader) // ASSGN SYS003,X'00D' (Punch) // ASSGN SYS005,X'00E' (Printer) // EXEC MW210

.

. (Conversion Parameter Cards)

.

. /* /&

1Group 1 Software -- List Conversion System 6.1 Callable Subroutines

- Three of the parameter-card functions of program MW210 are also provided in equivalent form as callable subroutines. These routines may be invoked from some process other than a full-scale List Conversion when the functions are required.

0 Routines EXAP and XTSP represent expanded Address Isolation and Street Split routines utilized by release 2.3. The previously issued routines, ISAP and STSP and included for compatability with existing user requirements.

0 The interface specifications for each routine are presented on the following pages.


Callable Subroutines 0Routine EXAP -- Extended Isolate Address Parts - Routine EXAP essentially provides the functions of the ISOLATE

ADDRESS PARTS and ISOLATE CITY-STATE parameters, in a callable routine. Three parameters are required, as follows:

0 1) The input area, consisting of six 50-byte address lines arranged in order as if they were to be printed on a label. Unused lines should contain blanks.

0 For option 'M' (Modify default tables), this 300-byte area has a different usage as noted below.


0Routine EXAP -- Extended Isolate Address Parts - 2) A single character describing the contents of the rightmost

non-blank line of the input area, as follows: 0 'N' - The last non-blank line is not a City line

'I' - The last non-blank line is a City line, and is to be ignored.

'C' - The last non-blank line is a City-State-ZIP line which is to be separated into its components.

0 'M' - Modify the default verification tables in ISAP according to the data presented in parameter 1. When this option is used, the tables are first reset to the following situation:

0 US ZIPs will be accepted, except for APO/FPO ZIPs Canadian Postal Codes will be rejected Australian Post Codes will be rejected

0 Then the 300 bytes of parameter 1 are examined and interpreted as follows:

0 001-003: APO to accept APO/FPO ZIPs, or blank 0 004-006: CAN to accept Canadian Postal Codes, or blank 0 007-008: Each of these two-byte fields is treated as

009-010: a (US) State, or Canadian Province, or 011-012 Australian Territory, which is to be ... rejected. Unrecognized abbreviations will

205-206: be ignored. 0 Note: for the purposes of the modification,

two-character alphanumeric abbreviations must be used for Australian Territories. The recognized values are:

0 A1 for NSW = New South Wales A2 for ACT = Australian Capital Territory A3 for VIC = Victoria A4 for QLD = Queensland A5 for SA = South Australia A6 for NT = Northern Territory A7 for WA = Western Australia A8 for TAS = Tasmania

0 207-207: (reserved) 0 208-210: AUS to accept Australian Post Codes, or blank

211-300: Ignored


0Routine EXAP -- Extended Isolate Address Parts - 3) The output area, containing 383 characters subdivided as

follows: 0

0

0

0

0

1-300:

301-335:

336-370:

371-372:

0

0

0

0

0

0

373-383:

Six 50-byte lines, never containing City information, and arranged such that the rightmost contains the most significant information. A 35-byte area containing the City name, as entered (blank if parameter 2 is not 'C'). A 35-byte area containing the State name, as entered (blank if parameter 2 is not 'C'). A 2-byte area containing the USPS standard State abbreviation (blank if parameter 2 is not 'C'). If the address is Australian, then this area will contain a two-character alphanumeric pseudo Australian Territory abbreviation, and the correct three-character Territory abbreviation will be stored in positions 368-370 of the output area (the state-as-entered field will therefore be truncated to 32 characters if necessary). The pseudo Territory abbreviations are:

A1 for NSW = New South Wales A2 for ACT = Australian Capital Territory A3 for VIC = Victoria A4 for QLD = Queensland A5 for SA = South Australia A6 for NT = Northern Territory A7 for WA = Western Australia A8 for TAS = Tasmania

A 11-byte area containing the ZIP Code as follows, or blank if parameter 2 is not 'C'. If only a 5-digit ZIP is encountered, this area will contain the 5-digit ZIP followed by five blanks. If a Canadian Postal Code is encountered, this area will contain that Postal Code stored left-justified, with a space between the FSA and the LDU. If a 9-digit ZIP Code (ZIP-Plus-4 Code) is detected, this area will contain the 5-digit ZIP Code, a hyphen, and the ZIP-Plus-4 add-on. If a 4-digit Australian Post Code is detected, this area will contain the Post Code, followed by 6 spaces.


0Routine EXAP -- Extended Isolate Address Parts - Note: If no proper ZIP Code can be located, the entire last line + ____

will be placed in the City name area, and the State and ZIP areas will be all blank.

0 If no State name can be found (which matches the ZIP), then the last line, exclusive of the ZIP Code, will be stored in the City name field, and the State fields will be blank. The ZIP field will be filled as noted.


0Routine ISAP -- Isolate Address Parts - Routine ISAP essentially provides the functions of the ISOLATE

ADDRESS PARTS and ISOLATE CITY-STATE parameters, in a callable routine. Three parameters are required, as follows:

0 1) The input area, consisting of six 35-byte address lines arranged in order as if they were to be printed on a label. Unused lines should contain blanks.

0 For option 'M' (Modify default tables), this 210-byte area has a different usage as noted below.


0Routine ISAP -- Isolate Address Parts - 2) A single character describing the contents of the rightmost

non-blank line of the input area, as follows: 0 'N' - The last non-blank line is not a City line

'I' - The last non-blank line is a City line, and is to be ignored.

'C' - The last non-blank line is a City-State-ZIP line which is to be separated into its components.

0 'M' - Modify the default verification tables in ISAP according to the data presented in parameter 1. When this option is used, the tables are first reset to the following situation:

0 US ZIPs will be accepted, except for APO/FPO ZIPs Canadian Postal Codes will be rejected Australian Post Codes will be rejected

0 Then the 210 bytes of parameter 1 are examined and interpreted as follows:

0 001-003: APO to accept APO/FPO ZIPs, or blank 0 004-006: CAN to accept Canadian Postal Codes, or blank 0 007-008: Each of these two-byte fields is treated as

009-010: a (US) State, or Canadian Province, or 011-012 Australian Territory, which is to be ... rejected. Unrecognized abbreviations will

205-206: be ignored. 0 Note: for the purposes of the modification,

two-character alphanumeric abbreviations must be used for Australian Territories. The recognized values are:

0 A1 for NSW = New South Wales A2 for ACT = Australian Capital Territory A3 for VIC = Victoria A4 for QLD = Queensland A5 for SA = South Australia A6 for NT = Northern Territory A7 for WA = Western Australia A8 for TAS = Tasmania

0 207-207: (reserved) 0 208-210: AUS to accept Australian Post Codes, or blank


0Routine ISAP -- Isolate Address Parts - 3) The output area, containing 292 characters subdivided as

follows: 0

0

0

0

0

1-210:

211-245:

246-280:

281-282:

0

0

0

0

0

0

283-292:

Six 35-byte lines, never containing City information, and arranged such that the rightmost contains the most significant information. A 35-byte area containing the City name, as entered (blank if parameter 2 is not 'C'). A 35-byte area containing the State name, as entered (blank if parameter 2 is not 'C'). A 2-byte area containing the USPS standard State abbreviation (blank if parameter 2 is not 'C'). If the address is Australian, then this area will contain a two-character alphanumeric pseudo Australian Territory abbreviation, and the correct three-character Territory abbreviation will be stored in positions 368-370 of the output area (the state-as-entered field will therefore be truncated to 32 characters if necessary). The pseudo Territory abbreviations are:

A1 for NSW = New South Wales A2 for ACT = Australian Capital Territory A3 for VIC = Victoria A4 for QLD = Queensland A5 for SA = South Australia A6 for NT = Northern Territory A7 for WA = Western Australia A8 for TAS = Tasmania

A 10-byte area containing the ZIP Code as follows, or blank if parameter 2 is not 'C'. If only a 5-digit ZIP is encountered, this area will contain the 5-digit ZIP followed by five blanks. If a Canadian Postal Code is encountered, this area will contain that Postal Code stored left-justified, with a space between the FSA and the LDU. If a 9-digit ZIP Code (ZIP-Plus-4 Code) is detected, this area will contain the 5-digit ZIP Code, a hyphen, and the ZIP-Plus-4 add-on. If a 4-digit Australian Post Code is detected, this area will contain the Post Code, followed by 6 spaces.


0Routine ISAP -- Isolate Address Parts - Note: If no proper ZIP Code can be located, the entire last line + ____

will be placed in the City name area, and the State and ZIP areas will be all blank.

0 If no State name can be found (which matches the ZIP), then the last line, exclusive of the ZIP Code, will be stored in the City name field, and the State fields will be blank. The ZIP field will be filled as noted.


0Routine ISFN -- Isolate Full Name - Routine ISFN essentially provides the functions of the ISOLATE

FULL NAME and GENDER CODE parameters, in a callable routine. Three parameters are required, as follows:

0 1) A 35-byte area containing the name to be isolated, in natural order (MR GEORGE J SMITH JR PHD), and padded on the right with blanks.

0 2) A 210-byte area in which will be placed the name parts, divided as follows:

0 1-35: Title of respect (MR) 36-70: First name (GEORGE) 71-105: Middle name (J) 106-140: Last name (SMITH) 141-175: Maturity title (JR) 176-210: Professional suffixÝes¨ (PHD)

0 3) A single byte which will be filled with a Gender Code determined from the name as follows:

0 A: ambiguous first name B: blank first name C: Company F: female first name I: initials only M: male first name U: unrecognized first name

- Notes: + _____ 0 When a company name is detected, then an asterisk is

placed in the first position of the Title area, the input name is placed in the Last Name area, and the Gender Code will be set to 'C'.

0 If no sense can be made of the input name, then it will be treated as follows:

0 The name will be laid out in the Last Name area as if it were a company name.

0 The Title area will contain an asterisk 0 The Gender Code will be set to 'U'.


0Routine XTSP -- Extended Street Split - Routine XTSP essentially provides the function of the STREET SPLIT

parameter card, in a callable routine. Two parameters are required, as follows:

0 1) A 50-byte area containing the address line to be split up. 0 2) A 60-byte output area, subdivided as follows: 0 1-10: The House number

11-12: The Leading Directional 13-47: The Remainder of the Street address 48-49: The Post Directional 50-53: The Apartment Designator 54-60: The Apartment Number


Callable Subroutines 0Routine STSP -- Street Split - Routine STSP essentially provides the function of the STREET SPLIT

parameter card, in a callable routine. Two parameters are required, as follows:

0 1) A 35-byte area containing the address line to be split up. 0 2) A 44-byte output area, subdivided as follows: 0 1-7 : The House number

8-9 : The Leading Directional 10-44: The remainder of the Street address

1

1Group 1 Software -- List Conversion System 7.1 Program MW211 -- Conversion Summary

- INTRODUCTION - This program summarizes the cards punched out of the MW210

program producing statistics for each of the following for the file converted:

0 Total input Total surname rejects Total city-state rejects Total ZIP Code rejects Total special rejects Total all rejects Total output Per cent surname rejects Per cent city-state rejects Per cent ZIP Code rejects Per cent special rejects Per cent all rejects

0 If a TAPEIP or DISKIP card is encountered, then at end-of-file on the card reader (SYS004), additional card-images will be read from

the file defined. The DDname or logical assignment for this file is

SYS002. See the MW210 Parameter Card section for a description of the TAPExx/DISKxx card.

- HEADER CARD LAYOUT 0 FIELD DESCRIPTION LENGTH POSITIONS 0 Asterisk (*) 1 1 - 1 0 This may contain any description 79 2 - 80

the user desires for the main head-ing line on the report. It will print in the first 79 print positions of each main heading line on each page.

- MW210 SUMMARY CARD LAYOUT - FIELD DESCRIPTION LENGTH POSITIONS 0 File Code (key code) 9 1 - 9 0 File Description 20 10 - 29 0 Total input 7 30 - 36 0 Total surname rejects 7 37 - 43 0 Total city state rejects 7 44 - 50 1Group 1 Software -- List Conversion System 7.2

Program MW211 -- Conversion Summary - Total ZIP Code rejects 7 51 - 57 0 Total special rejects * 7 58 - 64 0 Total all rejects 7 65 - 71 0 Total output 7 72 - 78 0 Blank 2 79 - 80 - * The special rejects are a sum total of user rejects that are

either rejected or skipped in an exit routine or rejected with the use of the 'COMPARE REJECT' parameters.


- PROGRAM FUNCTION: Conversion Summary PROGRAM NAME: MW211 0 SYS NR/ DEVICE I/O


T A SYS002 I Auxiliary Parameter file TAPEIP P E

o r

D I S K

U N I T S

0 SYS NR/ DDNAME DESCRIPTION OF CARD DISPOSITION

+ ______________________________________________________________________ 0 R SYS004 Summary Cards, o/p of MW210

P 0 SYS NR/ FORM CARRIAGE

DDNAME DESCRIPTION OF REPORT NUMBER TAPE DISPOSITION + ______________________________________________________________________

P R SYS005 Conversion Summary Report Std. Std. I N T E R


C O N S O L E

1


- SAMPLE DOS JCL - // JOB MW211

// ASSGN SYS004,X'00C' // ASSGN SYS005,X'00E' // EXEC MW211 * Heading information up to column 80

.

.

. (Summary cards)

.

.

. /* /&

0 SAMPLE OS JCL - //S1 EXEC PGM=MW211

//SYS005 DD SYSOUT=A,DCB=(RECFM=FBA,BLKSIZE=133,LRECL=133) //SYSUDUMP DD SYSOUT=A //SYS004 DD * * Heading information up to column 80

.

.

. (Summary cards)

.

. //

1

1Group 1 Software -- List Conversion System 8.1 DCOMPRES Program

- Extract Programs from Delivery tape - Narrative_and_flow: - Group 1 Control

Delivery Tape Cards + _____________ _________

| | | | | |

+ ________ ______________ | | | | V V

+ ___________________ | DCOMPRES | | Extract | | Source Programs |

+ ___________________ | | | V

+ ______________________________ Source programs and JCL/Control cards mixed on Tape, Disk, or Card Punch

- Extract_Source_Program(s) + _________________________ 0 DCOMPRES reads and tables a series of INSERT and/or COPY control

statements. If all Control cards are valid, it then reads the Group 1 Delivery Tape and honors the control statements in order of occurrence. Each INSERT statement causes a single card to be inserted into the output stream, and each COPY statement causes an entire source program (or text file) to be inserted into the output stream from the Delivery Tape. The output may be directed either to the card punch (by default), or to a Tape or Disk file (by use of a TAPEPN parameter card anywhere in the control card stream). OS users, of course, control the device type through the JCL provided. Whether or not a TAPEPN card is provided, the DDname, or logical assignment, of the output stream is SYS003.

0 Since the files to be decompressed are always the third, fourth, or fifth files on the Delivery Tape, OS users will need to specify (3,NL), (4,NL), or (5,NL) in the JCL, and DOS and OS/3 users will need to position the tape by MTC commands or the equivalent (and place an 'X' in column 26 of the TAPEIN card to specify no rewind).

0 In DOS shops which have ACLR (Access Control, Logging & Reporting), reading a no-label tape with no-rewind specified will be found to present a problem. In this case, proceed as follows:

___

0


- Copy the third (fourth or fifth) file from the delivery tape to another no-label tape (as the first file), using DITTO or the equivalent. Then use the new no-label tape as input to the DCOMPRES program specifying no labels but not specifying the no-rewind option.

+ 1Group 1 Software -- List Conversion System 8.3

DCOMPRES Program 0HEADER Parameter Card - CARD COLUMNS - 01 - 06 0 08 - 17

0 18 - 43

1

FIELD DESCRIPTION PARAMETER KEYWORD - Must contain 'HEADER'. DATE - May contain a date in the form MM/DD/YYYY. This date will appear on the output reports. If this field is left blank, the current date will be inserted. RUN DESCRIPTION - May contain any run description the user wishes. This run description will appear on the output reports.


0TAPExx Parameter Card - TAPExx or DISKxx cards must be used to activate each input or output

file. Following is a brief description of each of the possible files. See the System Overview section for a detailed description of the TAPExx/DISKxx card fields.

- File_Activators: + _______________ 0 IN - The Group 1 Delivery Tape. The record size and block

size should be specified as shown on the listing which accompanies the delivery tape.

0 PN - The output stream of control/source or text card-images. The record size is verified and must be 80.

- Note: If File PN is omitted, then the output stream will be + ____

directed to a card punch, using the same (SYS003) assignment.

1


0CONTRL Parameter Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'CONTRL'. 0 08 - 10 SEQUENCE NUMBER TREATMENT - May contain

a value to indicate the desired treatment of the sequence number field (columns 73-80) of the files to be extracted, as follows:

0 TXT - the file is a text file (a book), and the sequence number field is to be left as is

nnn - (a numeric value) the sequence number field is to be incremented by this value, and the number for the first card is to be this value

blank - the default treatment is '100'. 1 1Group 1 Software -- List Conversion System 8.9

DCOMPRES Program 0INSERT Control Card - CARD COLUMNS FIELD DESCRIPTION - 01 - 06 PARAMETER KEYWORD - Must contain 'INSERT'. 0 08 - 71 TEXT OF CARD - Must contain the text which

is to make up the output card-image, starting at column 1.

0 72 - 72 CONTINUATION COLUMN - Must contain the character which is to be placed in the output card-image in column 72 (normally the continuation column).

1


0COPY Control Card - 01 - 04 PARAMETER KEYWORD - Must contain 'COPY'. 0 06 - 08 FILE NUMBER - Must contain the File number

of the program or text file to be copied. Note that this is not the number of the file on

+ ___ the tape which contains all the programs (3), or all the text files (4), but the number of the program within file 3 on the tape, or the number of the book within file 4.

0 The listing accompanying the Delivery Tape will show the positions (file numbers) of the source or text files within each of the physical files on the tape. If the listing has been lost or destroyed, a new copy may be obtained by printing the first (physical) file on the tape. It consists of 80-byte card images blocked 8000.

0 10 - 17 FILE NAME - Must contain the name of the file to be copied, as it appears on the printed listing. The File name is checked against the File Number, and a mismatch condition will cause execution to terminate.

0 Note: As many COPY statements as desired may be provided, interspersed + ____

with INSERT statements if desired. However, the File Numbers of multiple files to be copied must be presented in ascending

sequence, and no File Number may be repeated.

0


0Operating Instructions - PROGRAM FUNCTION: Extract Source or Text PROGRAM NAME: DCOMPRES 0 SYS NR/ DEVICE I/O


T A SYS010 P E SYS003

o r

D I S K

U N I T S SYS NR/ DDNAME

+

I Group 1 Delivery Tape, TAPEIN File 3 or 4

O Output stream TAPEPN

DESCRIPTION OF CARD DISPOSITION ______________________________________________________________________

0 R SYS004 Control Cards P SYS003 Output Stream if no TAPEPN

0 SYS NR/ FORM CARRIAGE DDNAME DESCRIPTION OF REPORT NUMBER TAPE DISPOSITION

+ ______________________________________________________________________ P R SYS005 Parameter List and Execution I Log N T E R


C O N S O L E


0Operating Instructions - PROGRAM FUNCTION: Extract Source or Text PROGRAM NAME: DCOMPRES - Additional Operating Instructions: 0 Mount files as indicated, put proper forms in the printer, put

JCL and parameter cards in the card reader, and execute the program.

0 The parameters are read, edited, and listed on the printer. If errors are detected in the parameters, the parameters with errors are flagged, the tape files will not be opened, and the program will be terminated. If the parameters are error-free, the tape files will be opened and processing will continue until all Control Statements have been honored.


0Sample DOS JCL - The following illustrates the use of the DCOMPRES program to

create an unblocked tape that can serve as a SYSIN stream to assemble program MW210, the 14th program on a standard Group 1 delivery tape.

0 // JOB MAKE TAPE FOR MW210 ASSEMBLY // ASSGN SYS003,X'280' UNBLOCKED TAPE // ASSGN SYS004,X'00C' READER // ASSGN SYS005,X'00E' PRINTER // ASSGN SYS010,X'281' DELIVERY TAPE // MTC REW,SYS010 // MTC FSF,SYS010,2 // EXEC DCOMPRES HEADER MAKE ASMBLY TAPE - MW210 CONTRL 100 TAPEIN320048000VN 2 TAPE X TAPEPN 0080 080 N 2 TAPE INSERT // JOB ASSEMBLE MW210 INSERT // OPTION CATAL INSERT PHASE MW210,* INSERT // EXEC ASSEMBLY COPY 014 MW210 INSERT /* INSERT // EXEC LNKEDT INSERT /* INSERT /& /* /&


0Sample OS JCL - The following illustrates the use of the DCOMPRES program to

submit a job that will replace programs CR03, CR04, and M$05 (programs 3, 4, and 6 within physical file 3) in a source library. The programs are extracted by DCOMPRES, and embedded in the JCL stream as in-line files which will be stored as members by the job submitted.

0 //DCOMPRES EXEC PGM=DCOMPRES //STEPLIB DD as appropriate //SYS003 DD SYSOUT=(A,INTRDR), // DCB=(RECFM=F,LRECL=80,BLKSIZE=80) //SYS004 DD * HEADER LOAD THREE PROGRAMS CONTRL 010 TAPEIN320048000VN 2 TAPE X INSERT //COPY3 JOB as appropriate INSERT //COPY PROC P=XXX INSERT //* INSERT //COPYPGM EXEC PGM=IEBGENER INSERT //SYSPRINT DD SYSOUT=A INSERT //SYSIN DD DUMMY INSERT //SYSUT2 DD DSN=GROUP1.SOURCE(&P), X INSERT // DISP=OLD INSERT // PEND INSERT //* INSERT //CR03 EXEC COPY,P=CR03 INSERT //COPYPGM.SYSUT1 DD * COPY 003 CR03 INSERT //CR04 EXEC COPY,P=CR04 INSERT //COPYPGM.SYSUT1 DD * COPY 004 CR04 INSERT //M$05 EXEC COPY,P=M$05 INSERT //COPYPGM.SYSUT1 DD * COPY 006 M$05 //SYS005 DD SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=133) //SYS010 DD UNIT=2400-3,VOL=SER=CMnnnn,LABEL=(3,NL), // DSN=PROGRAM.FILE,DISP=(OLD,PASS), // DCB=(DSORG=PS,RECFM=VB,LRECL=8000,BLKSIZE=32004) //SYSUDUMP DD SYSOUT=A //


0Sample OS JCL - The following is a simpler example, in which DCOMPRES is used to

copy program IX01, the 17th program in the third physical file, directly into a source library.

0 //DCOMPRES EXEC PGM=DCOMPRES //STEPLIB DD as appropriate //SYS003 DD DSN=GROUP1.SOURCE(IX01),DISP=OLD //SYS004 DD * HEADER COPY IX01 CONTRL 100 TAPEIN320048000VN 2 TAPE X DISKPN 4240 080 S 2 COPY 017 IX01 //SYS005 DD SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=133) //SYS010 DD UNIT=2400-3,VOL=SER=CMnnnn,LABEL=(3,NL), // DSN=PROGRAM.FILE,DISP=(OLD,PASS), // DCB=(DSORG=PS,RECFM=VB,LRECL=8000,BLKSIZE=32004) //SYSUDUMP DD SYSOUT=A //

1

1Group 1 Software -- List Conversion System 9.1 Input/Output Section

- This section contains the file layout of the summary card, that is punched when the 'PUNCH KEY' parameter card is used.

0 This section can also be used for Input and Output file layouts commonly used by the user.

1


0CONVERSION SUMMARY CARD LAYOUT - FIELD DESCRIPTION LENGTH POSITIONS 0 File code (key code) 9 1 - 9

- * The special rejects are a sum total of user rejects that are either rejected or skipped in an exit routine, rejected with use of the 'COMPARE REJECT' parameter, or by using the overflow option for truncation on the 'FORMAT' parameter card.

1

0 File description 20 10 - 29 0 Total input 7 30 - 36 0 Total surname rejects 7 37 - 43 0 Total city state rejects 7 44 - 50 0 Total ZIP Code rejects 7 51 - 57 0 Total special rejects* 7 58 - 64 0 Total all rejects 7 65 - 71 0 Total output 7 72 - 78 0 Blank 9 79 - 80


0List Conversion Summary Statistics - File Name: List Conversion Summary Statistics 0 Block Size: 0 Label Records: 0

Field Description/Contents + ___________________________________ 0 Record ID ('LC ') 0 File Code 0 Description 0 Conversion Input 0 Rejects 0 Conversion Output 0 (reserved) 1

1Group 1 Software -- List Conversion System Input/Output Section

+

Record Size: 80 Mode: FB Recording Medium: sequential Data Field Field Format Length Positions ________ _______ __________ C 3 001 - 003 C 9 004 - 012 C 20 013 - 032 9 8 033 - 040 9 8 041 - 048 9 8 049 - 056 - 24 057 - 080

9.7

- Replace this page with sample List Conversion run. + 1

1Group 1 Software -- List Conversion System 10.1 - Index + _____ 0 - -- A --ACCEPT APO/FPO Card.....................................3.33 ACCEPT AUSTRALIA Card...................................3.35 ACCEPT CANADA Card......................................3.34 ACTIVATE EXIT ROUTINE

Card.................................................3.67 Example..............................................3.69 Exit 1 discussion....................................3.67 Exit 2 discussion....................................3.67 Exit 9 discussion....................................3.41 Parameter list.......................................3.68

ADJUST RDW Card.........................................3.137 ASCII TRANSLATE Card....................................3.43 Australian Post Code....................................3.35 Australian State Abbreviations..........................3.104 - -- B --BANNER WORD Card........................................3.9 Block off-set...........................................3.9 - -- C --Canadian Postal Code....................................3.34, 3.37

Printable form.......................................3.103 Canadian Provinces

rejecting............................................3.38 selecting by.........................................3.37

CENTER Card.............................................3.117 Checkpoint

CHCKPT Card..........................................3.23 Restart..............................................3.24

COLLAPSE NAME Card......................................3.55 COMPANY NAME Card.......................................3.75 Company Names

altering Work Areas..................................3.75 analyzing............................................3.71 conditional execution for

by FORMAT Card....................................3.111 by MOVE Card......................................3.102

defining indicators..................................3.75 marking convention...................................3.73 rejecting............................................3.76

COMPARE ACCEPT Card.....................................3.59 COMPARE REJECT Card.....................................3.59 CONSTANT Card...........................................3.21 CONTRL Card

DCOMPRES.............................................8.7 Conversion Summary

MW211................................................7.1

COPY Control Card DCOMPRES.............................................8.11

- -- D --

Delivery Tape

Direct Access Master File

Discussions

exit routines

Parameter Cards

- -- E --END OF FILE

forcing

EXTENDED ISOLATE ADDRESS PARTS

EXTENDED STREET SPLIT

-CVTB Card...............................................3.93 CVTD Card...............................................3.97

DCOMPRES Program........................................8.1

Extracting Programs from.............................8.1

VSAM.................................................2.15

Auxiliary Parameter File.............................2.31 Disk Cards...........................................2.11

EXITOP............................................2.27 TAPE/DISK exits...................................2.15

auxiliary file....................................2.31 grouping..........................................2.31

Tape Cards...........................................2.11 VSAM Master Files....................................2.15

DISKIP..................................................2.31 DISKxx Card (see also TAPE/DISK Card)...................2.11

Card.................................................3.7

by record count...................................3.29 for out-of-range..................................3.123 for out-of-sequence...............................3.121

non-standard.........................................3.7 EXAP....................................................6.3 EXITOP Card.............................................2.27 EXPAND AUSTRALIAN STATE Card............................3.104 EXPAND POSTAL CODE Card.................................3.103 EXPAND STREET ADDRESS Card..............................3.113

subroutine...........................................6.3

subroutine...........................................6.13 EXTRACT SECOND NAME Parameter Card......................3.65

6.7

- -- F --Field manipulating

Address Expanding suffixes................................3.113 Isolate parts of..................................3.81, 6.3, 6.7 Isolate Street parts..............................3.89, 6.13, 6.15

City/State Isolate parts of..................................3.85, 3.86, 6.3,

- collapsing........................................3.55 delimiter processing..............................3.57 formatting........................................3.49, 3.109 left justification................................3.61, 3.115 moving............................................3.47, 3.101 Range lookup......................................3.107 right justification...............................3.63, 3.119 shifting..........................................3.53 splitting.........................................3.57 stringing together................................3.49, 3.109 Table lookup......................................3.105

Key Code assigning by percentages..........................3.135

Names gender coding by..................................3.79, 6.11 Isolate parts of full.............................3.71, 6.11 Isolate parts of partial..........................3.77

Numeric binary............................................3.93 packing...........................................3.95 unpacking.........................................3.97, 3.99

PC Generated Files Comma separated fields............................3.57

sequence number generating........................................3.133

Title codes Converting........................................3.91

ZIP Isolating.........................................3.85, 3.86

FIELD SHIFT Card........................................3.53 File Activators

DCOMPRES.............................................8.5 MW210................................................3.3

File layout Conversion Summary Statistics........................9.5

footers for reports user-specified.......................................2.25

FORMAT Card.............................................3.109 FVAR Card...............................................3.49

- -- G --GENDER CODE

Card.................................................3.79 subroutine...........................................6.11

General Information.....................................2.10 - -- H --HEADER Card.............................................8.3

MW210................................................3.5 MW211................................................7.1

headings for reports user-specified.......................................2.25

- -- I --Indexed Master File VSAM.................................................2.15

Input file Printing records from................................3.139 Tape labels..........................................3.5

Input File variable-length records..............................3.13

INSERT Control Card DCOMPRES.............................................8.9

Introduction............................................1.1 MW211................................................7.1

IOMODS Card.............................................2.31 ISAP....................................................6.7 ISFN....................................................6.11 ISOLATE ADDRESS PARTS

Card.................................................3.81 subroutine...........................................6.7

ISOLATE CITY STATE Card.................................................3.86 subroutine...........................................6.3, 6.7

ISOLATE CITY STATE ZIP Card.................................................3.85 subroutine...........................................6.3, 6.7

ISOLATE FULL NAME Card.................................................3.71 subroutine...........................................6.11

ISOLATE PART NAME Card..................................3.77

- -- K --Key Codes

assigning by percentages.............................3.135 summary stats by.....................................3.17, 3.18

Summary File......................................3.19, 3.20 - -- L --Label handling..........................................3.5 LEFT JUSTIFY IP Card....................................3.61 LEFT JUSTIFY OP Card....................................3.115 limiting records processed..............................3.27, 3.29 LOWER/UPPER TRANSLATE Card..............................3.44 - -- M --MOVE Card...............................................3.101 MVAR Card...............................................3.47 - -- O --O/P-FILE DTF Card.......................................3.15 Operating instructions

DCOMPRES.............................................8.13 -Operating Instructions

MW210................................................5.1 MW211................................................7.3

Output File defining.............................................3.15 Printing records from................................3.139 variable-length records..............................3.15

Overview................................................2.1 - -- P --PACK Card...............................................3.95 PAGESZ Card.............................................2.23 Parameter Card list.....................................2.4 Parameter Cards

auxiliary file.......................................2.31 grouping.............................................2.31

Parameter List EXITOP...............................................2.27 for EXAP.............................................6.3 for Exit Routines....................................3.68 for ISAP.............................................6.7 for ISFN.............................................6.11 for STSP.............................................6.15 for TAPE/DISK Exits..................................2.15 for XTSP.............................................6.13

Post Code Australian...........................................3.35

Postal Code Canadian.............................................3.34, 3.37 Printable form.......................................3.103

PRINT Cards.............................................3.139

Provinces (Canadian)

- -- R --

Range processing

Reject Codes............................................3.31, 4.3

Rejecting records

PRINT FIELDS Cards......................................3.143

rejecting............................................3.38 selecting by.........................................3.37

PUNCH KEY Card..........................................3.17 PUNCH KEYS Card.........................................3.18

RANGE LOOKUP Card.......................................3.107

by ZIP...............................................3.123 RDW, adjusting of.......................................3.137 RECORD SIZE Card........................................3.13

REJECT COMPANIES Card...................................3.76 REJECT CONTROL Card.....................................3.31

by Postal Code.......................................3.125 by State or Canadian Province........................3.38 by User specifications...............................3.59 by ZIP Code..........................................3.125

- by ZIP range.........................................3.123

report footers

report headings

Restart skipping

by 3-digit ZIP.......................................3.125 controls for.........................................3.31 if Companies.........................................3.76 Printing rejected records............................3.139 ZIP/State mismatch...................................3.129

relocation of subroutines...............................2.33 Renaming subroutines....................................2.31

user-specified.......................................2.25 Report from Summary Card................................7.1

user-specified.......................................2.25

by record count...................................3.27 RIGHT JUSTIFY IP Card...................................3.63 RIGHT JUSTIFY OP Card...................................3.119

- -- S --Sample JCL

DCOMPRES.............................................8.15 MW210................................................5.3 MW211................................................7.5

Samples.................................................9.7 SCAN AND SPLIT Card.....................................3.57 Selecting records

by State or Canadian Province........................3.37 by User specifications...............................3.59 by ZIP range.........................................3.123

SELZIP Card.............................................3.127 Sequence checking

by ZIP Code..........................................3.121 Sequence number, generating.............................3.133 SEQUNO Card.............................................3.133 SPLIT FUNCTION..........................................3.135 START AFTER Card........................................3.27 State

assigning abbreviation by ZIP........................3.87 counting by..........................................3.131 rejecting............................................3.38 selecting by.........................................3.37 verifying abbreviation by ZIP........................3.129

State Abbreviations Australian...........................................3.104

STATE COUNTS Card.......................................3.131 STATE LOOK UP Card......................................3.87 STATE REJECT Card.......................................3.38 STATE SELECT Card.......................................3.37 STATE VERIFY Card.......................................3.129 STOP AFTER Card.........................................3.29 STREET SPLIT

Card.................................................3.89

10.7 1Group 1 Software -- List Conversion System -Index - subroutine...........................................6.15

Summary Card generating...........................................3.17, 3.18, 3.19 layout...............................................7.1, 9.3

Summary File

- -- T --

Tables

STSP....................................................6.15 Subroutines.............................................6.1

Extended Isolate Address Parts.......................6.3 Extended Street Split................................6.13 Isolate Address Parts................................6.7 Isolate Full Name....................................6.11 names of.............................................2.31 Street Split.........................................6.15

report from..........................................7.1

generating...........................................3.20 SUMMARY FILE CODE Card..................................3.20 SUMMARY FILE CODE CONSTANT Card.........................3.19 SYNCHK Card.............................................2.19

TABLE LOOKUP Card.......................................3.105

Maturity suffixes....................................4.1 MW210................................................4.1 P.O. Box.............................................4.1

Tape labels

TAPE/DISK Card..........................................3.3, 8.5

Translating

Prefixes.............................................4.1 Record Rejection Reasons.............................4.3 Rural Route..........................................4.1 State/Sectional Center...............................4.2 Street...............................................4.1 Titles...............................................4.1

Input file...........................................3.5

Field Description....................................2.11 TAPEIP..................................................2.31 TITLE TABLE Card........................................3.91 TRANSLATE CARD Card.....................................3.45

defining tables for..................................3.45 from ASCII to EBCDIC.................................3.43 from lower to upper case.............................3.44 specifying fields for................................3.45

- -- U --UFTnx Card..............................................2.25 UHDnx Card..............................................2.25 UNPK Card...............................................3.99 User Report Footers

defining.............................................2.25 User Report Headings

defining.............................................2.25 - -- V --Variable-length records

adjusting RDW........................................3.137 Input file...........................................3.13 Output file..........................................3.15

Verification of file content......................................2.19

VSAM Master Files.......................................2.15 - -- W --Work Areas

definitions..........................................2.2 - -- X --XTSP....................................................6.13 - -- Z --ZIP Code

accepting APO/FPO....................................3.33 assigning State Codes by.............................3.87 Australian...........................................3.35 Canadian.............................................3.34, 3.37 isolating............................................3.85, 3.86 Printable form.......................................3.103 range processing by..................................3.123 selection

range processing..................................3.127 sequence checking by.................................3.121 validity checking

ISOLATE ADDRESS PARTS.............................3.81 ISOLATE CITY STATE................................3.86 ISOLATE CITY STATE ZIP............................3.85 STATE COUNTS......................................3.131 STATE LOOK UP.....................................3.87 STATE VERIFY......................................3.129

ZIP CODE REJECT Card....................................3.125 ZIP RANGE Card..........................................3.123 ZIP SEQUENCE CHECK Card.................................3.121

GGGGGGG RRRRRRRRR OOOOOOO UUUU UUUU PPPPPPPPP …...1.1 List Conversion -- Introduction - PROGRAM...

Documents

Transcript of GGGGGGG RRRRRRRRR OOOOOOO UUUU UUUU PPPPPPPPP …...1.1 List Conversion -- Introduction - PROGRAM...