Programmer`s Manual Release 6.0

Registry of Motor Vehicles
UMS
Programmer’s Manual
Release 6.0
November 2002
T21494-1002
Registry of Motor Vehicles – UMS Programmer’s Manual
Table of Contents
CHAPTER 1. UMS OVERVIEW ...............................................................................................................1
PROSCRIPTIONS..............................................................................................................1
RELATED MANUALS......................................................................................................1
OVERVIEW .......................................................................................................................2
CHAPTER 2. CONTROL-DISPATCH......................................................................................................9
SYSTEM OVERVIEW......................................................................................................9
General Overview .............................................................................................................11
Main Control.......................................................................................................11
Host Interface......................................................................................................12
Output Services...................................................................................................12
Mapping/Demapping Services............................................................................12
Secondary Session Services................................................................................13
Control/Dispatch Conventions ..........................................................................................13
General Structure ..............................................................................................................18
Guest Side Conventions ...................................................................................................19
Host Side Conventions......................................................................................................20
Inter-Process Communication...........................................................................................21
Program Function-Key Standards .....................................................................................23
Guest-Host Control Blocks ..............................................................................................25
Guest Common Area Structure..........................................................................................27
UMS Software-Interface Hooks ........................................................................................30
Host Common Area Structure............................................................................................32
CHAPTER 3. UMS Naming and Version Conventions...........................................................................41
CHAPTER 4. UMS LIBRARIES AND MODULE PROMOTION .......................................................43
Proposed Module Movement Changes .............................................................................44
CHAPTER 5. UMS PROGRAM CONTROL TABLES .........................................................................53
Program Control Table Entry Guest (PCTEG) .................................................................53
Source Code Example - PCTEG.........................................................................54
The PCTEG In Detail .........................................................................................56
SYSPARM Options ............................................................................................58
Assembled Code Example ..................................................................................61
Hexidecimal Dump .............................................................................................68
Program Control Table Entry Host (PCTEH) ...................................................................71
Source Code Example - PCTEH........................................................................75
Assembled Code Example - PCTEH .................................................................77
Hexidecimal Dump of PCTEH Example ...........................................................84
Internal Function Codes ....................................................................................................87
Internal Function Codes List..............................................................................88
CHAPTER 6. LXTABLE PROCESSING................................................................................................91
Feature Summary ..............................................................................................................91
Detail Description .............................................................................................................96
The LXTABLE Macro .......................................................................................96
The UMSLXTBL TYPE=START.....................................................................97
Sample expansion, TYPE=START ......................................................98
The UMSLXTBL TYPE=DETAIL ...................................................................99
Table of Contents
iii
Registry of Motor Vehicles – UMS Programmer’s Manual
Value Checking ..................................................................................104
Edit Checking .....................................................................................106
Edit Type Table ..................................................................................107
User Exit - LXTABLE .......................................................................108
User Exit Example ...............................................................111
Internal Field Values - UMSLXMAC ..............................................................113
Sample Map Source Fragment ........................................................................................114
Sample Assembler Map Dsect ........................................................................................115
LXTABLE Assembled Example .......................................................117
Hexidecimal Dump of LXTABLE Example ......................................137
CHAPTER 7. SYSTEM UTILITY PROGRAMS .................................................................................139
Resident Utilities.............................................................................................................139
Date Conversion Routine..................................................................................140
Example of a COBOL Invocation ......................................................140
Data-Name Address Routine ............................................................................141
Miscellaneous Edit Services .............................................................................142
In-Core Online Sort ..........................................................................................143
Non-Resident Utilities.....................................................................................................144
Violation Table Processing...............................................................................144
CHAPTER 8. CICS TABLES .................................................................................................................149
UMS Setup Options ........................................................................................................149
CHAPTER 9. UMS SCREEN MAPPING PROCEDURES .................................................................161
CHAPTER 10. UMS ONLINE ERROR MESSAGES ..........................................................................171
UGZ0004P - The Message Module ................................................................................173
Assembled Example of a Message Module ....................................................................175
Hexidecimal dump of Message Module Example ..........................................................180
CHAPTER 11. SPECIAL SYSTEM FUNCTIONS...............................................................................181
Limited Secondary Session.............................................................................................181
UMS Screen Hop Facility ...............................................................................................182
ALARS-UMS Bridge......................................................................................................184
GHOST Program - ESI/NDR/CDLIS .............................................................................186
CHAPTER 12. UMS BATCH..................................................................................................................191
Tape Processing ..............................................................................................................191
CHAPTER 13. RECORD SURROGATES ............................................................................................195
APPENDIX A: NON-UMS LXTABLE EDIT EXAMPLE...................................................................201
APPENDIX B. GUEST PROCESS CONTROL TABLE.....................................................................223
APPENDIX C. HOST PROCESS CONTROL TABLE........................................................................237
APPENDIX D. CICS MISCELLANEOUS ............................................................................................261
CICS Abend Codes List.................................................................................................261
CICS Queue Names ........................................................................................................262
APPENDIX E. UMS SYSTEM PROGRAMS........................................................................................265
GUEST-SIDE PROGRAMS...........................................................................................265
HOST-SIDE PROGRAMS ............................................................................................266
Table of Contents
iv
Registry of Motor Vehicles – UMS Programmer’s Manual
APPENDIX F. GUEST COMMON AREA ............................................................................................267
COBOL Example............................................................................................................267
ASSEMBLER Example..................................................................................................272
APPENDIX G. FUNCTION DESCRIPTIONS .....................................................................................277
Function Titles List .........................................................................................................277
APPENDIX H. CICS IDMS NETWORK RELATIONSHIPS..............................................................379
NETWORK CONNECT OVERVIEW...........................................................................379
PRODUCTION ENVIRONMENT .................................................................379
TEST ENVIRONMENT .................................................................................380
TRAINING ENVIRONMENT.........................................................................382
MRO ENVIRONMENT ..................................................................................383
THE TMON V8.0 ENVIRONMENT...............................................................384
CICS - IDMS REGION RELATIONS ...........................................................................385
PRODUCTION ENVIRONMENT .................................................................385
TEST AND TRAINING ENVIRONMENT.....................................................386
Table of Contents
v
Registry of Motor Vehicles – UMS Programmer’s Manual
Table of Contents
vi
Registry of Motor Vehicles – UMS Programmer’s Manual
1
UMS Overview
Proscriptions
This UMS PROGRAMMER’S MANUAL is provided to assist those users who have a
definite requirement to modify or extend the UMS application software. There are five
important principles to guide such modifications and/or extensions:
1.
While the RMV provides problem determination and correction for the UMS
Guest Software, it cannot provide such support to user-modified or extended
Guest Programs.
2.
The UMS System Control and Support Programs named UGZxxxxP may not be
modified. The only exception is for those modules involved in site definition
whose modifications are specified in the Install Manual.
3.
All fields passed to the HOST for whatever purpose must successfully pass
their LXTABLE edit where such an edit is provided. The list on page 107 lists
the edits that must be employed. The section beginning on page 91 discusses the
LXTABLE in detail. The Appendix beginning on page 203 provides discussion
and examples of the LXTABLE use in programs outside of the UMS Control
Structure.
4.
Prior to making contact with the HOST, the UGTL transaction must have
executed successfully in the current execution of the CICS region concerned.
5.
Contact with the HOST will be effected only by means of the UMS System
Interface programs supplied by the RMV. Please refer to #2 above.
In addition, please read the convention section beginning on page 13 and the interface
section beginning on page 21.
Related Manuals
UMS Installation Manual: This book discusses the installation of the stated release. These
instructions preview the UMS system from a “high level” viewpoint.
Chapter One - UMS Overview
1
Registry of Motor Vehicles – UMS Programmer’s Manual
UMS Technical Manual: This manual discusses in detail each of the UMS transactions,
processing, programs, screens, records, and error messages. This is the best source,
outside of the programs themselves, of understanding the operation of the UMS
functions. Appendix G draws a synopsis for each function from this manual.
UMS User Manual: This is a “How-To” for using the system. The audience for this
manual is the End User.
UMS Customization Manual: This manual is a guide for modifying the UMS system
distributed to the user community with the other manuals. It is a subset of this book.
Overview
The Uninsured Motorist System (UMS) was developed to allow insurance companies to
notify the RMV when a policy on a vehicle had been cancelled, creating a possible
uninsured motorist. The system operates in both the batch and on-line mode. Over time,
enhancements have been made to the system to cover far more than insurance policy
changes. It has intimate connections with ALARS (Automated Licensing and Renewal
System) such that former distinctions are now blurred. To the same extent, the
responsibilities for these systems have changed as well.
The UMS system is built on a client-server basis. The RMV computer is the server, or
Host, for data on registrations, licensing, and related issues. Many of the clients or guests
are insurance companies or “outside” agencies with their own data processing facilities
and needs. UMS provides them with a complete interface and set of application
programs to access the RMV data. They are free to make modifications to the UMS
Guest programs. They are, however, required to use the UMS Structural and LXTABLE
edit facilities so they can maintain a maximum posture of release independence and
conform to data edit requirements. The system design places much of the workload on
their machine. The UMS design makes simple requests of the Host database system so
that the database run-units are short with as few I/Os as possible to give the very best
available response for all users.
A client who either modifies the released software or creates its own assumes full
responsibility for conforming to RMV data Standards.
A dozen CICS and IDMS regions provide the various classes of service required. The
diagram on page 5 illustrates the relationships. In all cases, CICS is the teleprocessing
and application front-end for the IDMS CVs. The database services are filtered through
the Logical Record Facility (LRF) of IDMS. The General User CICS region is the LU6.2
contact point in the Host for “guest” users who have connect privileges during normal
business hours.
Chapter One - UMS Overview
2
Registry of Motor Vehicles – UMS Programmer’s Manual
Three general types of Guest-Host interface are in service. These services are illustrated
in the following pages. In Type 1, the UMS Guest software resides in the Guest’s
mainframe and uses LU6.2 services to reach the RMV computer (see page 6). The RMV
host software does some validations, security checking, and the IDMS database I/O. The
Type 2 interface is used by several official agencies (see page 7). In this, the Guest
software runs in the RMV CPU and the LU6.2 facility is replaced by an interface
program. The Type 3 interface is similar to Type 1 but either the machine is not an IBM
or the user (guest) has heavily modified the “guest” software (see page 8). This is a case
of a “black box” communicating via LU6.2. We have no particular responsibility for
problems with this type of “guest” software.
For a more detailed description of functions or for error message information, consult
the UMS Technical Manual for this release level.
The overall design objectives are to use single function, independent modules and
segregate the front-end (CICS or TP) and back-end (IDMS or database) processing. This
has been achieved through several subordinate objectives or techniques. The first UMS
design objective is to place as much of the application work as possible in the Guest
software. The second objective is to drive the Guest and Host software systems with an
application control structure. This structure, called Control/Dispatch (CD), supports the
third objective, which is that development and maintenance time for applications be
minimized. CICS provides all the needed control facilities, but they must be hard-coded
into the programs. The programs become larger in size and complexity, and changes to
the processing structure cause changes to a number of modules. It is also difficult to run
new and old versions of programs in parallel.
The UMS CD system is table driven so that control flow changes are only applied in one
table. Common services, such as screen mapping, data movement, field editing, and error
message handling are all directed by the CD system and occur in system modules outside
of the application program. The chapters on Control Dispatch, UMS Program Control
Tables, and LXTABLE Processing describe these control mechanisms in detail. Many
utility routines are provided so that the application program can concentrate on the
specific business function and just call for basic “services” such as date routines.
Components are intentionally isolated so that debugging and error resolution is simplified
and new functions can be added without changing or disturbing the existing ones.
The fourth objective is function-reuse. This applies particularly to the Host side
functions that provide the database services. If a new requirement needs half of the data
provided by Host-function “X” and additional data not provided anywhere else, a new
Host function will be written to get the “additional data.” In this way, if there is a
problem with the function “X” data, there is still only one place to look for the problem.
There would be many possibilities if each new data requirement was met with a new
function providing only a specific group of fields. Such a proliferation would be
expensive in terms of development and a nearly insupportable nightmare in terms of
maintenance and problem resolution.
Chapter One - UMS Overview
3
Registry of Motor Vehicles – UMS Programmer’s Manual
The fifth objective is to make the interface to the DBMS as narrow and well defined as
possible. This ensures that the impact of changing the DBMS would be minimal to the
application systems. As a corollary, all programs must use the application “common type
services,” which operate through specific interfaces. This aids in development and, in
case of error or needed change, there is only one place to apply the correction and then all
programs will be using the new code. This principle is extended further in cases such as
license plate number edits where the edit rules set is elaborate and subject to sudden
change. The edit code is in a separate routine accessible to all applications but it is driven
by a set of rules that is downloaded from the Host at Guest start-up time. In this way, the
rules could be changed daily with no visibility to the users at all. This design eliminates
the need to manually distribute zaps or complete new copies of the rules tables and
ensures that all users are totally and painlessly up to date.
Chapter One - UMS Overview
4
Registry of Motor Vehicles – UMS Programmer’s Manual
OLSJCIQN
(Imaging)
Chapter One - UMS Overview
5
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter One - UMS Overview
6
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter One - UMS Overview
7
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter One - UMS Overview
8
Registry of Motor Vehicles – UMS Programmer’s Manual
2
Control - Dispatch
System Overview
The UMS Guest System requires initialization once the CICS region's startup is
complete. The UGTL transaction invokes UGZ0015P to perform the various operations.
This process is discussed in more detail in a subsequent chapter. If this process is not
completed, UMS will abend with a code of “UGTL” or “UGTH.”
The transaction “UG03” is the normal entry to the UMS Guest Processing. It invokes
UGZ0001P, the Guest Side Control Program. This routine controls the processing thread
for the transaction. Application programs that are invoked usually return to this routine
unless they abend. The control program examines the control structures and passes the
thread to the next program or function for the task. The focus of control is the system
portion of the common area and the PCTEG entry in UGZ0002P for the transaction in
flight. The PCTEG is discussed in detail later. It contains a list of programs to be
invoked in turn to do the work of the transaction. If the automatic screen mapping,
demapping, and editing feature is to be used, the name of the (LX) control table is given.
If a special clean-up program is needed, its name is given. Flags show the ability to do
updates, scrolling, and re-scrolling as well as the ability to communicate with the Host
System. Some additional features are discussed in the detailed treatment. The system
may also be invoked by external programs that start the transaction UG05 (that points to
UGZ0008P). UGZ0008P can be called directly by link or xctl.
At transaction initialization time, the data from the corresponding PCTEG entry is placed
into the system portion of the Guest Common Area. The structure of the Guest (and
Host) Common Areas are briefly covered in the following section of this chapter. The
control program and the application both refer to the Guest Common as the transaction
progresses. The application moves data elements only so a change of a program name is
transparent and will only require one change in the PCTEG entry for that transaction.
The order of the program names in the PCTEG is function dependent and the application
can vary the name moved to the 'next program' field depending on run-time conditions.
The first named program in the PCTEG list is the first one called by the control program
once mapping is complete. Any program can only be first for one transaction (and its test
version, 1st character = 'T'). When a screen of data is to be processed, the designated LX
map table is loaded and the LX map program completes its work before that first
application program is invoked. If the map module detects errors it can cycle through
error-message issue and re-try the mapping until the input is error free. The data from the
screen is placed into the dsect in the common area before the application gains control.
Chapter Two - Control - Dispatch
9
Registry of Motor Vehicles – UMS Programmer’s Manual
The program can edit the data further and issue error messages of its own to the screen
which will continue this cycle to correctness.
A number of service routines are available to do common functions such as upper-case
conversion and date conversions. These are described in Appendix G - Function
Descriptions. Calls to the Host side for database services can be made for retrieval and/or
update. Control can be returned to the caller or another program it designates. Each time
the thread returns control to CICS (except for logoff), the control program sets the next
transid to UG04. This id shows a continuing transaction to insure initialization that does
not negate work already done. If access to the Host System is indicated a Host Interface
Area block of storage is acquired and initialized by the Control Program. When the work
is complete and data is written to the screen, the Control Program invokes the LX-Table
feature to move the data to the screen. As is described in the LX-Table processing
chapter, exit routines may be summoned during screen processing (in or out) to perform
special editing. These routines can generate error messages.
Error messages are designated by a numeric value in Common Storage. This value is
used in conjunction with UGZ0004P, the Error Message Dictionary, to retrieve the actual
text and place it in the output map. When the thread comes back to the Control Program
as completed, the designated clean-up program , normally UGZ0005P, issues the write to
the terminal and makes any required final “adjustments.”
Each UMS screen normally has an LX table, guest input program, one or more host
programs, and a guest output program. When the user enters data onto the screen, the LX
table processor uses the LX table for that screen and edits the data. Next, the guest input
program receives control to format the guest-to-host blocks (refer to the Guest-to-Host
Blocks section) and performs any additional editing. The guest input program passes
control to the host side by using an internal function code to indicate which host
programs to invoke (refer to the Internal Function Codes section). The host programs
perform database access and formats the needed data into the host-to-guest blocks. The
guest output program receives the host-to-guest blocks, uses this data to make decisions
about screen highlighting, and performs other miscellaneous tasks. The last programs to
receive control are the LX table processor and the Clean up Program, UGZ0005P. These
programs use the screen's LX table to map the data from the General Storage Area (GSA)
to the screens, and sends the screen back to the user.
Chapter Two - Control - Dispatch
10
Registry of Motor Vehicles – UMS Programmer’s Manual
General Overview of UMS-Guest Control/ Dispatch
Control/Dispatch (often abbreviated CD) is the name given to the various service level
functions provided for the UMS guest application programs. There are two purposes to
CD. The first is to provide a level of standardization to functions common to multiple
application areas. The second is to perform functions deemed overly complex for the
typical application module.
General areas of functionality:
A.
B.
C.
D.
E.
Screen/CRT/CICS - Map management
Memory management
Function validation
Host interface
Table services
Each of these areas is a component of CD, and may exist as a unique module, or as a
component of a multi-purpose module(s).
Main Control
All UMS transactions are “wired” to the same PCT entry. UMS requires at least 2
transactions to run. One (typically UG03) is referred to as the initialization transaction.
Another (typically UG04) is referred to as the default run transaction. When the main
control program gets control, it determines if this is an initialization call by checking the
transaction name against the initialization transaction name. If the initialization
transaction is found, the common area is cleared, a flag indicating initialization is set, the
current map-name is set to the logon map, and control is transferred to output services.
Note that when the user comes back through, the logon process is treated in a manner
essentially the same as any other function, except that the user is required to complete
logon before a function change is allowed.
UMS supports three mechanisms of saving COMMAREA (Application-high core,
VSAM and CICS-high core). The main control module insures that the current
COMMAREA image is in an area located below the line.
CD determines if the user has changed the function-code. If so, the new function code is
validated. If it is valid and all required modules are present, the internal data is changed
to cause the selected function to be dispatched. If an error is detected, output services are
invoked to send the message to the user.
If no function is currently selected, output services are invoked to inform the user.
Chapter Two - Control - Dispatch
11
Registry of Motor Vehicles – UMS Programmer’s Manual
If a function key has been pressed, the meaning of the key is checked for validity in the
current environment. If it is invalid, output services are invoked to send the error
message to the user. Otherwise, the appropriate service is invoked.
The only remaining action is to dispatch the application. Most applications use table
driven mapping/ demapping (LXTBL) services, and a few do not. Those that do not use
LXTBL services are transferred directly. Those that use LXTBL, require that services be
dispatched before the application.
Host Interface
When an application determines that it must obtain data from the host, it builds the
application portion of a host parameter block and then transfers to the host interface
module defined for the guest. The interface module checks for the host being active,
completes the control portion of the host parameter block and transmits the data to the
host. When the response is received, the host interface module transfers back to the
requesting application. Note that if the host is not active, or if a fatal error is detected on
the host side, the host interface program directly invokes output services to post an error
message.
Output Services
Output services has four activities to perform:
1.
2.
3.
4.
Format the common map header (date, time, etc)
Lookup any message code in the message dictionary and place the text in
the map
Setup for saving the COMMAREA according to the site option for
COMMAREA location
Determine the next transaction code (specified for the executing function,
or the default run transaction)
Once these activities are complete, the map is sent, and the program returns.
Mapping/Demapping Services
Most applications use these services for processing maps. These services provide for
table driven transfer and editing of fields between the COMMAREA and the map buffer.
Some fairly sophisticated cross-field edits and host table edits are available. If errors are
detected, they result in the direct invocation of output services. Any application which
uses these services for demapping also uses them for mapping. Transferring these
services occurs before the application and before output services.
Chapter Two - Control - Dispatch
12
Registry of Motor Vehicles – UMS Programmer’s Manual
Secondary Session Services
This mechanism allows the user to temporarily leave the current function, perform
another function, and return to the original. CD treats the secondary session as a toggled
entity. If the second session is not active, the request must be made to activate; if it is
active, the request must be made to terminate. Activation consists of saving the
COMMAREA and current screen (via 3270- READBUF) in a temporary storage queue
and going through normal dispatch. Termination consists of restoring the COMMAREA
screen and going through normal output services.
Control/ Dispatch Conventions
This is a general set of guidelines, or rules, which must be followed in UMS applications
in order to maintain the proper interface with the control/dispatch mechanism.
1.
Module names are managed through the PCTE (G & H) entries in both the Guest
and Host systems. All reference to specific modules in the applications is via
cells in the common area loaded by control-dispatch. No application is to have
any reference to specific module names.
2.
Guest function names are managed through the PCTE entries. No reference to
specific function names (except for internal-only names) is to be present in any
set of application modules.
3.
Host function (block-type) codes follow the same conventions as guest function
names with respect to applications running on the host side. On the guest side,
applications calling host functions must be cognizant of the appropriate host
name, and seed it into the host interface area.
4.
In cases where a guest function is responsible for the output side of a particular
duplicate resolution, the parallel host function must be included in the appropriate
guest PCTE entry. With this exception, there is no parallelism between host and
guest PCTE entries.
5.
All maps must be generated using the standard UMS map header macro. This
results in all the UMS maps being identical in structure throughout the message
area. The structure forces one map per mapset. Further, all transmission and
receipt of terminal data is handled by the control-dispatch mechanism. This
means that control-dispatch will be responsible for providing an application with
an input-map when the application is invoked, and sending an output map when
the application exits to the control functions. Control dispatch also provides an
area in which the map variables may be placed by the application in concert with
cells for map-name, cursor position, message-code, message-text and length of
variable-data. This information allows proper map return.
Chapter Two - Control - Dispatch
13
Registry of Motor Vehicles – UMS Programmer’s Manual
Additionally, the LXTBL option provides a mechanism by which the control
dispatch mechanism relates map-data, map-name and common-area fields
automatically without specific application intervention. This feature provides for
raw field editing, support of basic field types including character, numeric, date,
expiration-date, internal zoned-decimal, internal packed-decimal, internal binary,
and internal compressed-date. Further, operands are being included on the
definition macros to provide for a wide range of field content editing and
cross-field editing.
6.
Control-dispatch is responsible for memory management. Application programs
may not contain GETMAIN/FREEMAIN (CICS or MVS) requests.
On the guest side, Control dispatch saves and restores the common area across
each pseudo-conversational interaction. Hooks exist on the guest side for the
acquisition of additional work area for specific functions which are not retained
across pseudo-conversational interactions. Such acquisition will be implemented
when a definitive need arises.
7.
Guest application programs for UMS are named in the PCTEG entries, and are
expected to be concise units aimed at specific business functions. Broad based
functionality is construed as being of a utility nature (such as the LXTBL
mechanism, date-conversion, address-editing, common field-editing, etc) and
being a function-dispatch service. Any services of this nature not currently
meeting these general needs will be provided as requested.
The general idea is that the application set defined for a given business function
will consist of 1 or more modules. The modules will be viewed as being between
the processing of terminal-input and a host dialogue, followed by 1 (or possibly
more) modules viewed as being between the receipt of a host response and
terminal-output. In practice, it is intended to be possible (when testing
modifications to a guest function) to run both old and new functions in the same
region by having one PCTE pointing at the old, and another at the new. This
clearly demands a narrow focus of application, with modules serving one business
function only.
The functional-independence of the module structure is required not only to
maintain these abilities, but also to insure that there is some reasonable potential
for guest users to migrate the functionality of this code to their existing systems.
8.
The same general set of criteria applies to the host. The host is viewed by the
guest as a data-server which operates on a quick in and out basis with the guest.
The host treats each guest interaction as a unique interaction, with no knowledge
of any previous interaction. The host common-area is not retained across
interactions with the guest.
Chapter Two - Control - Dispatch
14
Registry of Motor Vehicles – UMS Programmer’s Manual
There is no restriction against the guest going to the host more than once for a
given transaction. The intent is to push all work except raw data-service onto the
guest. Thus, all possible work is done at the guest side, and is not to be repeated
at the host side.
9.
The UMS control/dispatch contains mechanisms for interface with foreign
(non-UMS) applications, such as ALAR, SYSM, etc as well as any others that
may be running on the guest.
The specification of a business function as being external (foreign) occurs in the
guest PCTE entry, where the XFER= option must be specified with a value of
YES or DATA. Control may be passed to an external program or to another
Task. The LXTABLE discussion covers this feature in detail.
10.
UMS control-dispatch is able to accept control from foreign applications in the
same fashion as it can initiate them. The following are available to foreign
applications:
A.
B.
START the external initiation transaction (currently UG05), with or
without the 23-byte data area mentioned above.
XCTL to the external initiation module (currently UGZ0008P), with or
without the 23-byte data area mentioned above.
If no data area is passed, the effect is exactly the same as if a terminal level
initiation of the guest occurred.
When a data area is passed, control-dispatch attempts to sign the user on to UMS
using the ID/PASSWORD fields in the data-area. If this fails, the effect is the
same as if no data had been passed.
If the signon succeeds, the passed entry-reason code is checked for being a code
which could have been developed from keyboard entry. If it is not, it is forced to
the code for ENTER.
The entry is then sent through function-dispatch exactly as if it had come from a
keyboard. Generally, all functionality which would have been present from the
UMS function selection screen is supported. The only current exception to this is
that if the supplied entry-reason code references F4 or F9, any rescroll data
present for the device is lost.
11.
Scroll applications are expected to use the specified scroll-area for their
functionality, and thus not interfere with applications that might have exited to
them for duplicate resolution.
12.
Each guest business function is expected to maintain its own view of the structure
of the guest common work-area. There is no supported concept of a global view
Chapter Two - Control - Dispatch
15
Registry of Motor Vehicles – UMS Programmer’s Manual
of this area, and no assurance is thus present that all (or any) other applications
will follow the convention used by one particular application for this area. This
approach is essential for functional independence as well as the ability to test
functions on a modular basis. The same general concept applies to the host
common work-area.
Note that this discussion applies to areas described as application work areas, and
NOT to areas described as owned by control-dispatch.
13.
Clearly, the intent is that guest applications which specify a host interface area
consider this area to be an area provided in addition to the work-area at the end of
guest-common. Applications are expected to move data directly to and from this
area, without unnecessary buffering through common. It has clearly been stated
that if required, an ability to reference LXTBL processing to the host interface
area will be provided, as well as control-dispatch table-driven maintenance of the
host interface area. When the guest initiates some action, the host may take the
view that the guest's host-interface area is present in the specified section which is
in the middle of the host common. The actual amount of data moving in each
direction is driven by the detail length fields on both the host and guest. It is
important for performance reasons that the various host interface area formats be
constructed such that the minimum amount of space be used. Under no
circumstances should the application take the arbitrary attitude of always sending
the maximum length.
14.
Host applications should be constructed such that the minimum data needed for a
given guest activity is returned to the guest via the host interface area. The
passing of data elements (or data records) not needed for the current guest activity
is not to occur. In a similar manner, the guest sends only minimum data to the
host. For a typical retrieval operation, this would be perhaps a key and key-type.
For a typical update operation, this would be surrogate(s) and only the new (or
changed) data elements. In some critical update operations, also a significant data
element (which would be examined by the host for change, inhibiting the
operation if an intervening change occurred) might also be passed.
15.
There is clear intent to push activity to the guest, as well as to control activity on
the host. Host functions are intended to be data activities limited in scope and
with necessary relationships to each other. This serves as a natural choke on the
extent to which the various guests can load the host. In terms of the current
system, for example, the points at which RS, LP, and RN say “READ LIMIT
EXCEEDED” (or equivalent language) require a host return to guest. In a similar
fashion, the design of the guest to host requests for code being written must be
such that high host loads are avoided. Multiple guest to host interactions are
preferable.
Chapter Two - Control - Dispatch
16
Registry of Motor Vehicles – UMS Programmer’s Manual
16.
Message text for output should be through the message-code, message dictionary
facility. In defining the messages, the alias feature should be used whenever
possible.
17.
The application work area in guest common is 2290 bytes in length. The
application work area in host common is 512 bytes in length, it is preceded by the
2048 byte host interface area.
18.
The general relationship between function-dispatch and associated applications is
an XCTL relationship. In all cases, common (host or guest) is passed, using as a
length the half-word length cell contained in the appropriate common-area.
Applications MUST NOT have a hard-coded common length. The relationship
between various modules described in a given PCTE entry may be XCTL or
LINK (in either case passing common as above). The LINK relationship is not
desirable, and if used should not go down but one level.
19.
Modules (as opposed to functions) are not to be shared between UMS and ALAR.
This is for several reasons including (but not limited to) a requirement for not
having to test both systems in parallel during modification phases, differences in
coding conventions/structures and significant differences in internal security
structure.
20.
UMS contains a call-by-address mechanism which maintains reentrancy on the
called modules. This requires coding techniques which have not been applied to
call-by-address modules within ALAR, and that allow for CICS releases which
dispatch applications under multiple TCB’s thus requiring true reentrancy (not
quasi-reentrancy). As guests may be (and often are) running under CICS releases
well in advance of those at RMV, these techniques (and control-dispatch owning
of the involved modules) is a requirement for this kind of structure.
21.
The use of most of the Program Function Keys is standardized throughout the
system. Deviations from the standard must be approved in advance to avoid
adverse impact on the rest of the system and its users. The uses are listed on page
23.
At this point it would be helpful to read through the COBOL field names and the
assembler comments on the Guest Common Area field-layouts in Appendix "F" and
review the table beginning on page 27.
Chapter Two - Control - Dispatch
17
Registry of Motor Vehicles – UMS Programmer’s Manual
General Structure Specification
Host Side, “UMS” Interface
The host side of this product will consist of a set of modules which may be viewed as
existing in 5 logical levels, but in practice run in a 2 level structure. The following
diagram demonstrates the logical level structure, as best as can be represented in two
dimensions:
Level-1
UMS Protocall Processor(s)
Level-2
UMS Function Dispatch/Security
Level-3
UMS Functional Processors
(applications)
Level-4A
Non-Database Service Routines
Level -4B
Database Service Routines
Chapter Two - Control - Dispatch
18
Registry of Motor Vehicles – UMS Programmer’s Manual
Note that in the logical view, each level communicates down one level in a bidirectional
manner. Also, note that levels 4A and 4B should be viewed as being at the same logical
hierarchy, but so defined as to maintain a strict isolation between database and
non-database functionality.
This structure is logically correct, but introduces a series of relationships which do not
provide for the best utilization of resource under a CICS monitor. For this reason, the
logically separate levels (1, 2, & 3) are really at the same physical level in the actual
implementation. Each passes off laterally to its successor, and the last level 3 sequence
invoked passes off to the completion phase of level 2, which in turn passes off to the
return phase of level 1.
Guest Side Conventions
The general structure of the guest-side processes for UMS is similar to the existing
ALAR structure in that there is a control-supervisor structure which serves to provide
terminal services, a memory (common) area, interpretation of screen function-code, etc.
A set of service functions is also provided. The control-dispatch software is referred to as
“CD.”
The general flow of events is that CD will be entered as a result of a terminal input and
will ascertain if an active process is in progress for the transaction. If not, the active
process will be set to the signon process. In either case, a common-area will be acquired
(of the proper length for the process), and seeded with a value-set. The value-set will be
composed of values saved from prior invocations and information concerning the current
invocation.
CD will transfer to the specified application process via XCTL, passing a commarea.
This is the general pattern of operations throughout. CD seeds the commarea with a
number of module names including that of a cleanup module to which control must pass
when the application is complete. This process will issue the required transmission to the
terminal.
CD passes the first application process a set of flags concerning the reason for entry. The
potential reasons include (1) entry due to new function-code, (2) reentry due to enter, (3)
reentry due to F7/8, (4) entry due to F4, (5) reentry after host-interface, etc. It is
important to note that there is a high emphasis on small modules which use XCTL to pass
off for a next logical phase, as opposed to large single modules or many level deep
communication via LINK. The host interface requires access via XCTL.
The guest processing pattern is driven from a process control table. This table relates
external function-codes with a set of program-names, specifies function key
functionality/restrictions, defines common-area length, etc.
Chapter Two - Control - Dispatch
19
Registry of Motor Vehicles – UMS Programmer’s Manual
Because the intent is to provide code to the insurance industry which has reasonable
potential for customization and device migration, it is important that the front-end
function of input-map field fetching be separated from field processing. The guest
common area structure is given in detail in another chapter. The structure provides for a
scroll (browse) surrogate table and page table. Two bytes are provided for indicating
information relative to the format of this table. We intend that a relationship between the
process-control-table and the current format of these two bytes indicate if a current F4
type transfer is valid. Further, the F4 target is to be provided with information about its
source based on this input. We have no firm position on if the meaning of these two
bytes should algorithmically define the table, or if they should be a code defining the
table.
A number of cells are provided for GETMAIN areas, including map-in (provided by
CD), map-out, host-interface. Due to the requirement of complete input processing first,
the map-out area could overlay the map-in area. Further, if this were desirable, the
maximum map-out length for the process could be included in the process-control-table
entry for the function as obtained by CD. The CD save-commarea function is used
during the host interface activity.
Host Side Conventions
A major component of this development effort is the isolation of the various components
of the system from each other. The major components relative to the HOST side are:
1.
2.
3.
4.
5.
6.
7.
Protocol
Functional Control
Primary Security
Secondary Security
Primary Application Processes
Applications Service Routines
Database Service Routines
In order to maximize performance, every effort should be made to devise application
modules as short, functional processes that complete their designated activity and XCTL
to the next required functional process (or back to the cleanup process specified by
function dispatch if the application activity is complete). When choices must be made
relative to size, emphasis should be first on reducing working-storage and secondly on
reducing procedural sizes. Clearly, coding conventions that assist in this process should
be utilized. For example, switches and flags should be 1 byte alpha-numeric items and
compared to (or set to) literals as opposed to data-items.
The goal of component isolation is best achieved in our current environment in the area
of database access. The structure of this product implies that the database is sufficiently
removed from the applications that the access method might be changeable without
Chapter Two - Control - Dispatch
20
Registry of Motor Vehicles – UMS Programmer’s Manual
application change. In turn, this means that database functionality would be served by a
set of service modules which would accept function-codes (and involved data), and
perform actions (returning status information and/or data). Thus, in the current
environment, all IDMS verbs and interactions exist at the 4B (database service) level
only. The parameter and data-record passing with the higher level(s) is done with
standard CICS and COBOL mechanisms, meaning that the higher level modules are not
compiled with the IDMS preprocessor and that standard copy members exist for the
passage of data between the 4B and other levels.
In a similar fashion, most of the security processing is completely removed from the
applications. The only extent to which the applications are involved with security
concerns cases where the security determination is based on field content. For these
situations, the application needs to be aware of the existence of a security constraint
concerning a given field within the application. The responsibility of the application
(when retrieving the involved data) is to call the security assist routine passing the
address of the field(s) and an identifying function-code. The security assist routine will
pass back a return-code from a set such as the following:
00
01
02
03
No security constraint implied.
User cannot see field. Security has overlaid field data with “nonexistent”
value for passing to user.
User cannot see involved record. Treat identical to record-not-found.
User process to be abended. Security has seeded return area with
appropriate error-code. XCTL to cleanup process.
It is important to note that when the applications traverse down levels using LINK (or
CALL if an assist routine is involved), the error-code field in the common-area text body
needs to be evaluated for a non-zero content. If this circumstance occurs, the invoked
level must immediately return up 1 level. Since each level will contain such checking
(similar to a return-code test) the effect will be that as soon as the error-code becomes
non-zero, the cleanup process will be invoked.
Inter-Process Communication, “UMS” Interface
In the traditional fashion, a common area will be used to maintain the memory items
necessary for any invocation of these processes. This common area will have several
differences from the one in use for the existing ALAR Supervisor. The most glaring of
these differences is that the common area will NOT be preserved across invocations from
the same end node.
In concept, the UMS Protocol Processor will acquire the common area, initialize certain
cells and pass the area to the Function Dispatch Processor. In turn, the area will be
passed from process to process until the cycle is complete. The detail structure of the
common area is given later. Its general structure is as follows:
Chapter Two - Control - Dispatch
21
Registry of Motor Vehicles – UMS Programmer’s Manual
Area 1:
Protocol Control Area:
This area is reserved for use by the protocol processor.
Area 2:
Module Control Name Area:
This area is used for the storage of module-names that are required in the
course of the various processes. These names are placed here at
transaction start-up time by the UMS-GUEST Control Program. The
control program extracts these names from the Guest Program Control
Table (PCTEG) based on the transaction code entered. The intention is
that no program manipulate hard-coded program name literals. The
literals will only be in the table so that a change in the table will be
completely effective throughout the entire run-time system.
Area 3:
Assist Routine/Table Addresses:
This area is used for the storage of the entry-point addresses of functional
assistance modules which are commonly used and whose residence is
insured prior to invocation of any application process. Typical examples
of entries here are date-conversion routine, address conversion routine,
specialized move routine for structuring return messages, etc.
Area 4:
Post-Function Security Data:
This area is used to hold data required for security functions which cannot
be evaluated prior to function initiation. The design of the UMS
processing is that the function-dispatch level is cognizant of any items
which the existing ALAR software would classify as subfunctions and
interrogates security prior to entering applications on this level. However,
this information is used for the resolution of data dependent security items.
Area 5:
Interchange Text Body:
This area holds the message from/to the guest. The input-side protocol
process seeds this area with the input text, and clears all cells used to
control output/error flow. The applications (using the provided assist
routines) build the response (and error-codes) in this area for eventual
return to the guest. The defined size of this area will limit the maximum
length response possible for a given message.
Area 6:
Data Services Work Area:
This area is a generalized area used for both communications with the
service routines (database and non-database), as well as a work-area for
the invoked application programs. By convention, the service routines
will use the area from the top down, and the applications will use the area
from the bottom up.
Chapter Two - Control - Dispatch
22
Registry of Motor Vehicles – UMS Programmer’s Manual
Program Function Key Standards
The UMS System contains capabilities programmed into the function keys. Throughout
the UMS Subsystem, some of these function keys can be used to move back and forth
between primary and secondary sessions and functions, while others facilitate simpler
operations, such as scrolling the screen data.
The following is an explanation of each function key's use within the system. Please note
that this is a general list for the entire system, and not all function keys are available to
each function. The individual documentation for each function will indicate the function
keys available.
F1
The F1 key will return the user to the signon screen. However, if the user
is currently positioned at the signon screen, the use of the F1 key will
return to CICS.
F2
The F2 key moves the user to the UMS Menu screen. Use of this key is
equivalent to entering UMM in the function field and pressing the “Enter”
key.
F3
The F3 key can be used only in a primary session with screens containing
a built-in reference list. The user must request a function change and
move the cursor to a selectable item on the reference list before invoking
the limited secondary session via F3.
F4
The F4 key is used to select a record from a scroll screen and switch to a
secondary function. The user must enter the desired function and move
the cursor to the desired record before invoking this function.
F5
The F5 key is not currently used in UMS.
F6
The F6 key is used to invoke the “Screen Hop” facility, a method of
carrying information to another inquiry screen after a change of function
code.
NOTE: As this procedure is unique and fairly involved, the user should
consult the separate documentation on the "Screen Hop" facility for a
complete explanation.
F7
The F7 key is used to page backwards on a scroll screen. This key is also
used on screens which process more records than can fit on one screen.
NOTE: Although UMS allows paging forward through an entire set of
screen data, backward scrolling permits a maximum of eleven (11) pages.
Chapter Two - Control - Dispatch
23
Registry of Motor Vehicles – UMS Programmer’s Manual
F8
The F8 key is used to page forward on a scroll screen. This key is also
used on screens which process more records than can fit on one screen.
F9
The F9 key is used after UMS has automatically invoked a scroll screen
due to the specification of a duplicate key by the user. The cursor is
moved to the desired line item and F9 is pressed to return to the original
function.
F10
The F10 key is not currently used in UMS.
F11
The F11 key is used to reinvoke the last scroll function at the exact point
the user left it to invoke the current function. The user must enter the
appropriate function code prior to pressing F11.
F12
The F12 key is used in update functions to update the database with the
values shown on the screen.
Special Session Definitions
Scroll Screens
Some screens are classified as scroll screens. This implies that they present a list of
records whose keys are in some way similar (or identical). The screens may be entered
by direct user entry of the function code, or automatically by the programs if the
programs determine that the user entry is insufficient to decide between similar records
stored on the database. The idea is that the user will, by means of cursor positioning and
function keys, make the final determination of the desired record.
Most Scroll screens support paging forward and backward, as well as paging by partial
pages. The actual selection of the desired record is accomplished by an internal “Browse
Table” mechanism.
Reference Lists
Some screens build a “Reference List” to provide additional information about records on
the screen. This list is accessed and used in a manner similar to the Scroll Screen/Browse
Table mechanism, but is intended for brief examination of supportive detail rather than as
a general processing path.
Chapter Two - Control - Dispatch
24
Registry of Motor Vehicles – UMS Programmer’s Manual
Primary and Secondary Sessions
UMS allows the user to maintain both the normal (or Primary) session and a Secondary
session. When the secondary session is invoked, the entire environment which describes
the primary session is preserved and restored on return. The intent is that the secondary
session can be used for detail reference which may be required to continue the activity
being accomplished in the primary session, without the necessity to back out of the detail
entered in the primary, and later reenter it. Generally, any inquiry function can be
accomplished in either session, but update functions are restricted to the primary session.
At any time, the user can determine which session is active by examining the date in the
top left corner of the screen.
♦ If the separators are the “/” character, the session is primary.
♦ If the separators are the “-” character, the session is secondary.
The user may directly invoke a secondary session which allows all inquiry functions, or
may cursor select a limited secondary session which allows only one inquiry function.
Guest-Host Control Blocks
The guest/host (guest-to-host and host-to-guest) blocks are used as communication areas
between the guest software at the insurance companies, and the host software at the
RMV. Guest-to-host blocks contain data to be sent from the guest to the host side, and
host-to-guest blocks contain data to be sent from the host to the guest side.
These blocks are defined in the host and guest programs, and the host-to-guest block for a
screen is usually defined in the LX table. An LX table is a macro that performs editing
and mapping for a screen. If changes are made to the host-to-guest block, then the SE
must make the changes to the applicable LX table also.
NOTE: The UMS screen “UPH” will be used as an example throughout this description.
The guest-to-host blocks contain key data fields and information. The key data fields,
moved from the applicable UMS screen, that are necessary to perform the database
retrieval on the host side. The other data in this block consists of data retrieved from the
database and data used for updating screens. The guest-to-host block for each UMS
screen is different because all screens have unique key data fields and some are inquiry
only while others are updatable. Guest-to-host blocks vary in length, but each has 62
bytes at the top that are “reserved” for specific functions.
♦ The first 40 bytes of the 62 contain routing data, security data and the four-byte
internal function code for that screen.
Chapter Two - Control - Dispatch
25
Registry of Motor Vehicles – UMS Programmer’s Manual
♦ The next 22 bytes of the 62 contain error information, various indicators and other
information, or may be used for duplicate key logic.
For “UPH,” these 22 bytes contain key data for the screen so that if duplicates are
encountered during host data base retrieval, duplicate processing may be based on the
contents of the 22 bytes.
Interface modules are invoked when transferring from the guest side to the host side and
vice-versa. These interface modules use the first 62 bytes of the guest-to-host blocks for
their processing (routing and duplicate key logic). The interface modules send the 62
bytes, along with the rest of the block, to the applicable host program in its common area.
Each guest input program moves the length of its guest-to-host block to the common area
before transferring control to the host side. This length tells the interface modules the
length of the applicable guest-to-host block being passed. The length is determined by
subtracting 40 bytes from the total length of the guest-to-host block. The 40 bytes
subtracted are part of the 62 reserved bytes at the beginning of the block.
The “UPH” screen's guest-to-host block consists of 40 bytes used for routing, security,
and the internal function code, followed by 22 bytes used for duplicate key logic,
followed by the rest of the block. The total length of this guest-to-host block is 214
bytes, so the response length is 174 bytes:
214 bytes - 40 bytes = 174 bytes.
When NDR was implemented, the “UPH” screen's 22 bytes, reserved for duplicate key
logic, were not enough to hold the 25 byte out-of-state license plus the 2 byte state code
(27 bytes total). Five bytes were added to the block, immediately following the 22 bytes,
to hold the full 27 bytes needed for duplicate key logic.
Once control has been sent to the host side, the applicable host program saves the guestto-host block received by moving it from one area of the common area to another. The
applicable host program is either the input that performs data base retrieval, or the output
that performs database updates. The area that the guest-to-host block had previously
occupied is initialized to low-values and will be filled with the host-to-guest block to be
sent back to the guest output program. The host-to-guest block will contain data moved
from the guest-to-host block, in addition to applicable data obtained after the host
program has performed the database retrieval/update. The majority of the data sent back
to the guest output program, in the host-to-guest block, will be displayed on the screen.
Before transferring to the guest side, the host program moves the length of its host-toguest block to the common area. This length will tell the interface modules the length of
the applicable host-to-guest block being passed. Each host-to-guest block has a different
length. For the “UPH” screen, the block consists of a fixed header (174 bytes) and up to
ten details (each is 47 bytes). The length may vary based on how much data was
retrieved from the database (in contrast to the “UPH” screen's guest-to-host block, which
Chapter Two - Control - Dispatch
26
Registry of Motor Vehicles – UMS Programmer’s Manual
is constant). The formula used to compute the length for the “UPH” screen's host-toguest block is as follows:
174 + (47 * # of details) = length (up to 644 bytes)
When the guest output program receives control from the host program, it will process
the data transmitted in the host-to-guest block. Some of this data is moved to the
common area. When the LX table is executed, data from the common area is moved to
the output map. When the guest input program receives control from CICS again, it will
take the data from the common area (which the guest output program moved), plus any
new data entered on the screen, and move it to the guest-to-host block. This block will
again be sent to the host programs and the cycle repeats itself.
Guest Common Area Structure
(4074 bytes in length)
Note that each section of the common-area has been described in a separate definition.
The length of each section is given, and the content is described as offsets relative to the
section. COBOL and BAL layouts will be provided. Areas which are used by high-level
functions (and are transparent to the applications) have not been detailed. Most areas
preceding the application work-area must be treated as read-only by the applications.
There is a small set of exceptions to this which are noted. The general organization of
this structure is very similar to the host side.
Protocol Control Area
Bytes
0000-0007
0008-0009
0010-0011
Len
08
02
02
0012-0015
0016-0017
0018-0021
0022-0023
0024-0035
0036-0042
0043-0043
0044-0047
0048-0048
0049-0063
04
02
04
02
12
07
01
04
01
15
(64 bytes in length)
Usage
general purpose double-word aligned temporary
length of common-area. halfword aligned for XCTL, LINK.
current inquiry/response detail length. initialized to zero and
maintained by appropriate assist routine(s).
current function-name
internal control flag bits
previous function-name
length of last receive-map
process control flags from PCTE for current function
previous map-name
internal flag
next or current transid
internal flag
reserved for protocol dependency
Chapter Two - Control - Dispatch
27
Registry of Motor Vehicles – UMS Programmer’s Manual
Module Control Name Area
Bytes
0000-0007
0008-0015
0016-0023
0024-0031
0032-0039
Len
08
08
08
08
08
0040-0047
08
0048-0055
0056-0063
0064-0071
0072-0079
0080-0087
0088-0095
0096-0103
0104-0111
0112-0119
0120-0127
0128-0135
0136-0191
08
08
08
08
08
08
08
08
08
08
08
56
Usage
guest-to-host protocol interface module
1st application service module for current invocation
2nd application service module for current invocation
3rd application service module for current invocation
4th application service module for current invocation (cleanup
module)
note that only 1 application module is required for a given
function.
after-host return module. copied by application into this cell from
one of the preceding 4.
optional edit/map/demap table (LXTBL) module
crt sendback module
internal dispatch routine
reference list manager
non-resident services module
Lxtable processor
report print proc
level 2 host call
CICS BR14 equiv
host IO handler
printer interface
room for additional names
Assist Routine/Table Area
Bytes
0000-0003
0004-0007
0008-0011
0012-0015
0016-0019
0020-0023
0024-0027
0028-0031
0032-0191
Len
04
04
04
04
04
04
04
04
160
Len
24
(192 bytes in length)
Usage
address of date-conversion module
address of data-name to address conversion routine
address of text fetch routine for host output text
address of text fetch routine for host input text
address of guest control-table
address of translate/test table set
address of edit utility set
address of Shell Sort routine
room for 40 additional entries
Post Function Security Data
Bytes
0000-0023
(192 bytes in length)
(24 bytes in length)
Usage
reserved for security interface data
(5 addresses used, 1 available)
Chapter Two - Control - Dispatch
28
Registry of Motor Vehicles – UMS Programmer’s Manual
Scroll Function Data
Bytes
0000-0003
0004-0005
0006-0017
Len
04
02
12
0018-0084
0085-0085
67
01
0086-0181
96
0182-0741
560
(742 bytes in length)
Usage
last scroll-function name
reserved
scroll table descriptor. built by application program.
1 bytes #entries per line, zoned decimal.
1 bytes #surrogates per entry, zoned decimal (1-8)
2 bytes first line used on screen, binary
8 bytes surrogate type table
scroll key. built by application program.
core status flag. set by application. must be ‘Y’ if scroll-area is
considered valid.
page management table. Used by application for page forward and
page back. Format is at application discretion. (12 8-byte entries)
scroll/browse table. set of up to 140 4-byte entries surrogate
entries formatted as indicated by the scroll descriptor table. Built
by application, used by function-dispatch.
WARNING: Cells above this point are read-only unless otherwise noted. Cells
below this point are read-write unless otherwise noted.
Data Services Work Area
Bytes
0000-0001
0002-0021
Len
02
20
0022-0028
07
0029-0030
0031-0031
0032-0035
0036-0037
0038-0097
02
01
04
02
60
0098-0101
0102-0105
0106-0109
0110-0113
0114-0129
0130-0130
04
04
04
04
16
01
0131-0131
01
0132-0135
04
(512 bytes in length)
Usage
flags for data-move routines
date conversion area. contains EIBDATE in binary format on
initial function-entry if LXTBL is not used.
name of current map. set by application if not using LXTBL.
Read-only if using LXTBL.
Entry reason-code for current invocation
type of surrogate if entry is F4 or F9. read-only.
surrogate value if entry is F4 or F9. read-only.
EIBDATE in binary (WAASDATE) format. read-only.
reserved surrogate list. application agreement is required on which
significant surrogate is in which cell.
output map-length. read-only if LXTBL used.
address of input-map area. read-only.
address of output-map area. read-only.
address of host-interface area, zero if no area. read-only.
reserved for up to 4 additional addresses. read-only.
error-intercept flag. set to ‘Y’ by application if host errors are to be
intercepted without return to the application.
internal dispatch type. application must set to ‘0’ if using an
internal dispatch service.
name of function requested for internal dispatch.
Chapter Two - Control - Dispatch
29
Registry of Motor Vehicles – UMS Programmer’s Manual
0136-0159
0160-0511
24
352
first 24 detail bytes from last host call. read-only.
reserved
Undefined Area
(2 bytes)
Bytes
0000-0001
Usage
reserved
Len
02
Error/Message Area
Bytes
0000-0003
0004-0053
Len
04
50
Cursor Area
Bytes
0000-0001
(54 bytes)
Usage
current error/message code
override text
(2 bytes)
Len
02
Usage
cursor position data. read-only if LXTBL used.
Individual Application Work Area
Bytes
0000-2289
Len
2290
(2290 bytes)
Usage
reserved for any use any application wants to make of this area.
Preserved across psuedo-conversational interactions by
control-dispatch. not guaranteed relative to format between
applications.
UMS Software-Interface Hooks
The guest side of the UMS system has been designed to minimize points of interface with
the external environment and to provide specific points where a user site can hook to the
system with reasonable levels of effort and impact.
As a general design, UMS Guest:
♦ Interfaces with the host in only one module - UGZ011P
♦ Obtains normal 3270 input in only one module - UGZ0001P
♦ Outputs normal 3270 output in only one module - UGZ0005P
Normal 3270 input/output is used in the context of CICS RECEIVE-MAP and SENDMAP. Additionally, the 3270 device is accessed in READ-BUFFER mode and/or SEND
mode when the secondary session is entered or exited.
Chapter Two - Control - Dispatch
30
Registry of Motor Vehicles – UMS Programmer’s Manual
As a design objective, we have assumed that the user site might typically desire to log
transmissions to and/or from the host and/or generate its own interactions with the host.
To this end, the host activity was centered in one module, UHZ0011P (not distributed).
We have tried to make it relatively easy for the user to write these activities to a log or
invoke a user program (exit) to process them. To that end, we wrote the code such that
we believed the points at which this would be done to be relatively obvious.
Secondly, the data structure passed to UGZ0011P is such that it can be generated
relatively easily without using all of the UMS Guest software. This allows invoking the
host from some other program at the guest site without using the normal guest
dispatch-control mechanism. As a matter of practice, this is the technique used by
UGTL/UGTH (the guest initialization) transactions to invoke the host and can be seen in
a limited form in UGZ0020P.
If a user site elects this approach, the site commits itself to using the RMV’s guest host
data block formats. These formats are subject to potential change, but have been
designed to make the upgrade as painless as possible. In particular, the design includes a
4 byte block type field with a commitment on the part of the RMV to provide an overlap
period where both the old and new block type codes function. Such an overlap period
allows the unmodified guest an upgrade window and the modified guest a development
window (if required). Because the RMV is committed to at least one guest which is
totally a user development effort, it is clear that some degree of documentation will
proceed any block type changes.
It would also be possible for a user site to hook into the UGZ0001P and UGZ0005P
programs with the intent of simulating BMS map input/output functions. However, the
following cautions are in order:
1.
Across releases to date, UGZ0011P has been very stable and we expect this to be
an ongoing trend. UGZ0001P has not been stable, and we do not expect it to be.
UGZ0005P has been more stable than UGZ0001P and less than UGZ0011P. Any
user hooking these programs commits themselves to perpetuating their code
across all new releases in critical modules where the RMV has no design intent to
support release exits or other assistance for this effort.
2.
The RMV has every intention of modifying (as required for bugs or development)
screen formats at release time. Such modifications would seriously impact any
user who elected to hook in this method.
3.
The current UMS Guest takes some effort to be reasonably efficient in its 3270
transmissions. Such efforts will certainly increase as the product matures.
Knowledge of this position should indicate to anyone planning to hook our
SEND-MAP images the amount of work required. Also any such effort would
have to at least be cognizant of the 3270 READ-BUFFER usage.
Chapter Two - Control - Dispatch
31
Registry of Motor Vehicles – UMS Programmer’s Manual
Host Common Area Structure
(3072 bytes in length)
Note that each section of the common-area has been described in a separate definition.
The length of each section is given, and the content is described as offsets relative to the
section. COBOL and BAL layouts will be provided. Areas which are used by high-level
functions (and are transparent to the applications) have not been detailed.
Protocol Control Area
Bytes
0000-0007
0008-0009
0010-0011
Len
08
02
02
0012-0071
60
(64 bytes in length)
Usage
general purpose double-word aligned temporary
length of common-area. halfword aligned for XCTL, LINK.
current response detail length. initialized to zero and maintained
by appropriate assist routine(s).
reserved for protocol dependency
Module Control Name Area
Bytes
0000-0007
0008-0015
0016-0023
0016-0191
Len
08
08
08
176
Usage
output-side protocol processor name
cleanup processor name
1st application service module for current invocation
room for 22 additional names (13 in use)
Assist Routine/Table Area
Bytes
0000-0003
0004-0007
0008-0011
0012-0015
0016-0191
Len
04
04
04
04
176
Len
64
(192 bytes in length)
Usage
address of date-conversion module
address of data-name to address conversion routine
address of text insertion routine for output text
address of data-dependent security evaluation routine
room for 44 additional entries
Post Function Security Data
Bytes
0000-0063
(192 bytes in length)
(64 bytes in length)
Usage
reserved for data-dependent security function use
Chapter Two - Control - Dispatch
32
Registry of Motor Vehicles – UMS Programmer’s Manual
Interchange Text Body
Bytes
0000-0023
0024-0035
0024-0035
0036-0039
0040-2047
(2048 bytes in length)
Usage
Routing information. Used by Guest. Returned with response.
inbound security descriptor area.
4 bytes guest site name
4 bytes guest sub-site name (agent)
4 bytes guest sub-site password
(note that this field is not valid when passed to application
processes)
12
outbound timing data (provided by protocol processor)
6 bytes same as inbound security descriptor
2 bytes time of response
2 bytes date of response
04
Block (transaction) type code (same as inbound)
1 bytes subsystem code (reg, lic, ums, etc)
3 bytes subsystem function code
2008 This area constitutes the maximum length variable text for
guest-to-host or host-to-guest transmissions. The treatment of this
area is different depending on the direction of the transmission.
Len
24
12
Host-to-Guest
Bytes
0040-0043
Len
04
0044-0047
0048-0049
0050-0061
0061-2047
04
02
12
??
Usage
Application dependent response status flags. Byte 0040 used for
scroll response:
‘1’ data presented ends scroll (end-of-set)
‘2’ data presented does not end scroll
error-code. from defined list.
response count. 00=none, 01=one, etc.
error qualifier for output.
transaction dependent response for output.
Guest-to-Host
Bytes
0040-0060
0061-2047
Len
22
??
Usage
preserved header portion of input transaction
variable text body
The concept being suggested here is that logically the variable portion of the input text
body consist of two areas. These areas are separate only in that the function dispatch
process will isolate the first 22 bytes previous to invoking the application process, and
place it as shown below. From an application perspective, this allows formatting the
inbound text with critical data first, and so placed that the application need not have
concern about overlaying this data with initial response data. From a control overhead
Chapter Two - Control - Dispatch
33
Registry of Motor Vehicles – UMS Programmer’s Manual
perspective, in the case of longer input text bodies, the time spent shifting data down (as
was previously envisioned) is reduced.
Data Services Work Area
Bytes
0000-0511
Len
512
(512 bytes in length)
Usage
reserved for data-services and application use. First 22 bytes are
used to preserve the first 22 bytes of the input text body. Next 16
bytes are defined as standard parameter locations for assist
routines. When not calling the routines using these cells, they may
be overlaid.
Verify Program (Batch) Sample Report
Beginning on the next page is a Batch Sample Report.
Chapter Two - Control - Dispatch
34
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
35
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
36
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
37
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
38
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
39
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Two - Control - Dispatch
40
Registry of Motor Vehicles – UMS Programmer’s Manual
3
UMS Naming and Version
Conventions
All of the UMS application material (Subschemas, Copy Members, Programs, LX tables,
and Maps) will use the following naming standard. The Module Name has the form of
‘ABCDDDDE’ where:
A
Constant of 'U' For UMS System
B
Constant of ‘G’ For Guest Site
Constant of ‘H’ For Host Site
Constant of ‘I’ For Independent(used in both)
Constant of ‘V’ For Virtual Guests
C
Application Function
B
C
E
H
I
L
M
N
P
R
S
U
V
W
Z
Booking System (exam)
Cash
Emmissions
MAB
Inspection Maintenance
License Modules
MRB
Non-Renew License
Policy Modules
Registration Modules
Suspension
UMS & Cross System
Motor Voter
Overweight Permits
System Control Modules, General (edits, tables, etc.)
DDDD
Number 1 through 9999
E
Type of Program
P
M
L
T
J
Program
Map - (Guest side)
Subschema - (Host side)
LX table - (Guest side)
JCL
Chapter Three - UMS Naming and Version Conventions
41
Registry of Motor Vehicles – UMS Programmer’s Manual
G
Y
Copybook
Copybook
Chapter Three - UMS Naming and Version Conventions
42
Registry of Motor Vehicles – UMS Programmer’s Manual
4
UMS Libraries and Module
Promotion
The UMS online subsystem uses different source, load, and macro libraries than ALARS.
Following is a list of the libraries and their corresponding CVs:
Source libraries:
RMVMV.RMV.UMSSRCE
RMVMV.RMV.UMSSRCE2
RMVMV.RMV.UMSSRCE3
RMVMV.RMV.UMSSRCEP
CV10
CV13
CV14
CV11
Load libraries:
RMVMV.RMV.UMSLOAD
RMVMV.RMV.UMSLOAD2
RMVMV.RMV.UMSLOAD3
RMVMV.RMV.UMSLOADP
CV10
CV13
CV14
CV11
Macro libraries:
RMVMV.RMV.UMSMACRO
RMVMV.RMV.UMSMACR2
RMVMV.RMV.UMSMACR3
RMVMV.RMV.UMSMACRP
CV10
CV13
CV14
CV11
When a programmer makes changes to a program or copy member, he/she should first
look in the CV that has the current source. For example, if the source to be changed is
found in CV14 and CV11, the source from CV14 should be moved to CV10. The
changes should be made in CV10.
The CV11 production program-source, object modules, and macro source from
production are loaded onto a tape and installed at each client site.
Chapter Four - UMS Libraries and Module Promotion
43
Registry of Motor Vehicles – UMS Programmer’s Manual
Proposed Module Movement Changes
This paper is a proposal to simplify the module movement and to combine the module
movement of ALARS and UMS into one process. This document will address the
movement of source, macro, and load libraries, but will not address the issue of
subschema moves.
Currently the ALARS process is partly manual and partly automated. The UMS is
completely automated. Both systems have separate sets of libraries. This is just a couple
of many differences and possible areas for problems.
With the new library structure all of the systems will still have its own set of libraries.
All modules will move to CV14 before going into production. This would give the users
a chance to test the changes in an environment similar to CV11. Separate
macro/copybook libraries will be maintained for the ALARS and UMS systems so that
we are able to extract and deliver the needed members for the UMS guest sites. UMS
will have an additional separation for the Host and Guest software.
An online (TSO) clist would be developed to enter all requests and generate the
appropriate control cards for the movement of modules. Another series of reports would
be developed to produce control totals and modules that are moving. All of this would
eliminate the need for retyping of requests and any potential problems. Module
movements would still occur on the days that are now in place. At a later point in time
maybe Info Management might be the place to enter these requests.
While reading this document, keep in mind the drawings attached to get a feel of what is
happening in this new scenario. You will notice that ALL library names have changed to
better identify which IDMS region that they are working with. As today all
developments/enhancements will be done in CV10.
After the tests have run successfully and it is desired to move the modules closer to
production, a request can be entered to move the module(s) to CV14 and CV13. The
modules will be moved, but this time to the HOLD libraries for ALARS MMS moves;
UMS modules will be moved from CV10 to CV14 directly. The scheduled job will move
these modules to the processing CV14 and CV13 libraries.
MMS and UMS modules, except MMS load, will be moved to appropriate production
libraries. All MMS loads are moved to temp library RMVOL.JMV.TMPLIB, and after
10 days will be moved to the regular production library. On-line application MMS and
UMS loads are moved to RMVMV.RMV.PRODLOAD library also.
Just a reminder that the modules are moved and not copied, therefore, the “from” library
modules are deleted and can only be found in the “to” library.
Chapter Four - UMS Libraries and Module Promotion
44
Registry of Motor Vehicles – UMS Programmer’s Manual
The schedule of events is:
Every night except Saturday and Sunday
Tuesday nights
-
moves for CV13 and CV14
moves for CV11
If a module needs to move from CV10 to CV14 in the same night, it is done with a T to
M (test to mirror) move procedure.
UMS Move Clist
1
Overview
A new procedure has been created to make the process of moving modules and
copybooks between the various test regions and production simpler and hopefully less
prone to error.
This process is now completely automated. All that a programmer needs to do to move
programs and copybooks between the various regions is to request the move using the
UMSMOVE clist.
Moves between all the “test” regions are scheduled to run Monday through Friday.
Production moves are only scheduled to run on Tuesday nights, for Wednesday morning
implementation.
Moves outside of these times will be emergency moves. That means that the move will
be run straight away and programs will be “new copied” into CICS. To perform an
emergency move, the request is made in the same fashion. A phone call should then be
made to the Software Development Manager to get the move procedure completed.
If there are any problems with the clist, the Software Development Manager should be
contacted.
2
Procedure
2.1
Introduction
There are two combinations of libraries that serve as origin and destination libraries.
These are:
TEST to MIRR
MIRR to PROD
Chapter Four - UMS Libraries and Module Promotion
45
Registry of Motor Vehicles – UMS Programmer’s Manual
This enforces the rule that everything has to be moved to the mirror regions before going
to production. If it is necessary to move entities from TEST or SPCL to production
without doing any intermediate testing, then a move first needs to be made to mirror,
followed in short succession by the move from mirror to production
The programmer is responsible for specifying the members to move and the library
combination. This is achieved using CLIST “UMSMOVE.”
The actual move will be performed by jobs scheduled to run in the evening. Production
move jobs will run Tuesday night only for Wednesday morning implementation. All
other moves will run Monday through Friday during the evening.
2.2
“UMSMOVE” Clist
“UMSMOVE” uses SPF panels to allow the programmer to specify:
♦
♦
♦
♦
♦
The origin/destination combination
The names of members to be moved
The type of member (program[P] or copybook/macro[M]).
Date the move is to be performed
Optionally a CSR number.
The SPF panels have help panels.
When the CLIST first starts up, it will display a panel asking the programmer to enter the
Origin and Destination combination. Once entered, the CLIST will display another panel
that will show any move entries outstanding for the programmer. The programmer can
then add, delete, or modify the entries on the list.
Line commands “I” and “D” are available to Insert and Delete member entries. Updates
to line entries are made by over-typing.
Validation is as follows:
♦ Member names are verified to ensure that they conform to IBM standards and
that they exist on the appropriate library(ies). A program move assumes both
source and load is to be moved.
♦ Member type - “P” for program (source and load), “M” for Copybook or
Macro, “S” for Subschema source or program source only, “L” for program
load only.
♦ Dates are verified to ensure they are valid (February 29th is not valid for this
CLIST). It is important to use the correct use date. The date should reflect
the next scheduled move or the actual date for an emergency. All entries that
have passed a date, without being moved, will be deleted.
Chapter Four - UMS Libraries and Module Promotion
46
Registry of Motor Vehicles – UMS Programmer’s Manual
F8 and F7 can be used to scroll through the list of entries.
Command line entries are:
CANCEL
SAVE
END
ALL
-
NOTALL
-
H, HIST
-
HISTALL
-
Cancel changes and exit CLIST
Save changes made and continue with CLIST
Save changes and exit CLIST
Display entries for all users. This will only work for staff
responsible for moves
If “ALL” or “HISTALL” was entered, reverts to only
display entries for person signed on.
This will display a screen showing the moves that have
happened on the past for the person signed on.
Display history entries for all users. This will only work
for staff responsible for moves and selected others.
MMS ALARS Load Library Name
CV10
-
RMVMV.RMV.LOADLIB
RMVOL.JMV.MODLIB
RMVMV.RMV.HLDMOD
CV13
-
RMVMV.JMV.OFCLIB
RMVOL.JMV.OFCLIB
CV14
-
RMVMV.JMV.OFCLIB
RMVOL.JMV.OFCLIB
CV12
-
CV11
-
RMVMV.JMV.USRLIB
RMVOL.JMV.USRLIB
RMVMV.JMV.USRLIB
RMVOL.JMV.USRLIB
- TEST BATCH LOAD
- TEST ONLINE LOAD
- TEMPORARY HOLD
BATCH LOAD FOR
MOVE
- SPECIAL BATCH
LOAD
- SPECIAL ONLINE
LOAD
- MIRROR BATCH LOAD
- MIRROR ONLINE
LOAD
- MODEL BATCH LOAD
- MODEL ONLINE LOAD
- PRODUCTION BATCH
LOAD
- PRODUCTION ONLINE
LOAD
Chapter Four - UMS Libraries and Module Promotion
47
Registry of Motor Vehicles – UMS Programmer’s Manual
UMS Load Library Name
CV10
-
CV13
-
CV13
-
CV14
CV12
-
CV11
-
RMVMV.RMV.UMSLOAD
- TEST BATCH AND
ONLINE LOAD
RMVMV.RMV.UMSLOAD2 - CONCATENATION
SPECIAL BATCH AND
ONLINE LOAD
RMVMV.RMV.UMSLOAD3 - SPECIAL BATCH AND
ONLINE LOAD
- MIRROR BATCH AND
ONLINE LOAD
RMVMV.RMV.UMSLOADM - MODEL BATCH AND
ONLINE LOAD
RMVMV.RMV.UMSLOADP - PRODUCTION BATCH
AND ONLINE LOAD
Concatenation Load Libraries for the TEST Region
RMVOL.JMV.MODLIB
RMVOL.JMV.TMPLIB
RMVMV.RMV.UMSLOAD
RMVMV.RMV.UMSLOAD2
RMVMV.RMV.UMSLOAD3
RMVOL.JMV.USRLIB
RMVMV.RMV.UMSLOADM
-
ALARS ONLINE TEST LOAD
ALARS ONLINE TEMP LOAD
UMS ONLINE TEST LOAD
UMS ONLINE SPECIAL LOAD
UMS ONLIE MIRROR LOAD
PRODUCTION ONLINE LOAD
MODEL
Concatenation Load Libraries for the SPCL Region
RMVOL.JMV.OFCLIB
-
RMVOL.JMV.TMPLIB
RMVMV.RMV.UMSLOAD2
RMVMV.RMV.UMSLOAD3
RMVOL.JMV.USRLIB
RMVMV.RMV.UMSLOADM
-
ALARS ONLINE SPECIAL/MIRROR
LOAD
ALARS ONLINE TEMP LOAD
UMS SPECIAL LOAD
UMS MIRROR LOAD
PRODUCTION LOAD
UMS MODEL LOAD
Chapter Four - UMS Libraries and Module Promotion
48
Registry of Motor Vehicles – UMS Programmer’s Manual
Concatenation Load Libraries for the MIRR Region
RMVOL.JMV.OFCLIB
-
RMVOL.JMV.TMPLIB
RMVMV.RMV.UMSLOAD3
RMVOL.JMV.USRLIB
-
ALARS ONLINE SPECIAL/MIRROR
LOAD
ALARS ONLINE TEMP LOAD
UMS MIRROR LOAD
PRODUCTION LOAD
Concatenation Load Libraries for the MODL Region
RMVMV.RMV.UMSLOADM
RMVMV.RMV.PRODLOAD
RMVOL. RMV.TMPLIB
RMVMV.RMV.UMSLOADP
-
CV12 UMS TEST LOAD
CONSOLIDATED LOAD
TEMPORARY LOAD
UMS PRODUCTION
Concatenation Load Libraries for the PROD/ADMIN
Region
RMVMV.RMV.PRODLIB
-
PRODUCTION LOAD
Libraries for Test (CV10) Region
RMVMV.RMV.UMSMACRO
RMVMV.RMV.NDRMACRO
RMVMV.RMV.UMSSRCE
RMVMV.RMV.NDRSRCE
RMVMV.RMV.UMSLOAD
RMVMV.RMV.LOADLIB
RMVOL.JMV.MODLIB
RMVMV.RMV.HLDSOR
-
RMVMV.RMV.HLDMOD
-
RMVMV.RMV.UMSMACRO.BKUP
RMVMV.RMV.UMSSRCE.BKUP
RMVMV.RMV.UMSLOAD.BKUP
CV10 UMS MACRO
CV10 ALARS MACRO
CV10 UMS SOURCE
CV10 ALARS SORCE
CV10 UMS LOAD
CV10 ALARS BATCH LOAD
CV10 ALARS ONLINE LOAD
CV10 HOLD BATCH AND ONLINE
SOURCE FOR MMS MOVE
CV10 HOLD BATCH AND ONLINE
LOAD FOR MMS MOVE
BACKUP CV10 UMS MACRO
BACKUP CV10 UMS SOURCE
BACKUP CV10 UMS LOAD
Chapter Four - UMS Libraries and Module Promotion
49
Registry of Motor Vehicles – UMS Programmer’s Manual
Libraries for SPCL (CV13) Region
RMVMV.RMV.UMSMACR2
N/A
RMVMV.RMV.UMSSRCE2
RMVMV.JMV.CV13SOR
RMVMV.RMV.UMSLOAD2
RMVMV.JMV.OFCLIB
RMVOL. JMV.OFCLIB
RMVMV.RMV.UMSMACR2.BKUP
RMVMV.RMV.UMSSRCE2.BKUP
RMVMV.RMV.UMSLOAD2.BKUP
CV13 UMS MACRO
CV 13 ALARS MACRO
CV13 UMS SOURCE
CV13 ALARS SOURCE
CV13 UMS LOAD
CV13 ALARS BATCH LOAD
CV13 ALARS ONLINE LOAD
BACKUP CV13 UMS MACRO
BACKUP CV13 UMS SOURCE
BACKUP CV13 UMS LOAD
Libraries for MIRR (CV14) Region
RMVMV.RMV.UMSMACR3
N/A
RMVMV.RMV.UMSSRCE3
RMVMV.JMV.CV13SOR
RMVMV.RMV.UMLOAD3
RMVMV.JMV.OFCLIB
RMVOL.JMV. OFLCIB
RMVMV.RMV.UMSMACR3.BKUP
RMVMV.RMV.UMSSRCE3.BKUP
RMVMV.RMV.UMSLOAD3.BKUP
CV14 UMS MACRO
CV14 ALARS MACRO
CV14 UMS SOURCE
CV14 ALARS SOURCE
CV14 UMS LOAD
CV14 ALARS BATCH LOAD
CV14 ALARS ONLINE LOAD
BACKUP CV14 UMS MACRO
BACKUP CV14 UMS SOURCE
BACKUP CV14 UMS LOAD
Libraries for ADMIN/PROD (CV11) Regions
RMVMV.RMV.UMSMACRP
RMVMV.JMV. MACLIB
RMVMV.RMV.UMSSRCEP
RMVMV.JMV.SORLIB
RMVMV.RMV.UMSLOADP
RMVMV.JMV.USRLIB
RMVOL.JMV.USRLIB
RMVMV.RMV.PRODLOAD
-
RMVMV.RMV.UMSMACRP.BKUP
RMVMV.RMV.UMSSRCEP.BKUP
RMVMV.RMV.UMSLOADP.BKUP
CV11 UMS MACRO
CV11 ALARS MACRO
CV11 UMS SOURCE
CV11 ALARS SOURCE
CV11 UMS LOAD
CV11 ALARS BATCH LOAD
CV11 ALARS ONLINE LOAD
CV11 ON-LINE APPLICATION
LKOADLIB FOR ALL SYSTEMS
BACKUP CV11UMS MACRO
BACKUP CV11 UMS SOURCE
BACKUP CV11 UMS LOAD
Chapter Four - UMS Libraries and Module Promotion
50
Registry of Motor Vehicles – UMS Programmer’s Manual
Libraries for MODL (CV12) Region
RMVMV.RMV.UMSLOADM
RMVMV.RMV.UMSMACRP
RMVMV.JMV. MACLIB
RMVMV.RMV.UMSSRCEP
RMVMV.JMV.SORLIB
RMVMV.RMV.UMSLOADP
RMVMV.JMV.USRLIB
RMVOL.JMV.USRLIB
RMVMV.RMV.PRODLOAD
-
RMVMV.RMV.UMSMACRP.BKUP
RMVMV.RMV.UMSSRCEP.BKUP
RMVMV.RMV.UMSLOADP.BKUP
CV11 UMS MACRO
CV11 ALARS MACRO
CV11 UMS SOURCE
CV11 ALARS SOURCE
CV11 UMS LOAD
CV11 ALARS BATCH LOAD
CV11 ALARS ONLINE LOAD
CV11 ON-LINE APPLICATION
LKOADLIB FOR ALL SYSTEMS
BACKUP CV11UMS MACRO
BACKUP CV11 UMS SOURCE
BACKUP CV11 UMS LOAD
Module Movement
Libraries for each CICS
CV10 (TEST) -
RMVMV.RMV.UMSSRCE
RMVMV.RMV.UMSLOAD
RMVMV.RMV.UMSMACRO
CV13 (SPCL) -
RMVMV.RMV.UMSSRCE2
RMVMV.RMV.UMSLOAD2
RMVMV.RMV.UMSMACR2
CV14 (MIRR) -
RMVMV.RMV.UMSSRCE3
RMVMV.RMV.UMSLOAD3
RMVMV.RMV.UMSMACR3
CV11 (ADMIN) (PROD)
RMVMV.RMV.UMSSRCEP
RMVMV.RMV.UMSLOADP
RMVMV.RMV.UMSMACRP
CV12 (MODL) -
RMVMV.RMV.UMSLOADM
Modules are MOVED from CV10 to CV14 and CV13.
Modules are COPIED from CV14 to CV11.
Chapter Four - UMS Libraries and Module Promotion
51
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Four - UMS Libraries and Module Promotion
52
Registry of Motor Vehicles – UMS Programmer’s Manual
5
UMS Program Control Tables
One of the objectives of the UMS system design is the simplification of application
design, coding, maintenance, and release-control. This is especially important where a
part of the software (the Guest system) is distributed to outside users. To this end, the
system control structure is maintained outside of the application programs. Applications
are not to issue CICS Program Control Macros because these involve program-name
literals. If one is to change program names or the flow of control then all affected
programs must be changed and recompiled. In UMS, UGZ0001P / UHZ0001P
(Guest/Host Control Program) in conjunction with the UGZ0002P / UHZ0002P
(Guest/Host Control Table is used to control the execution of the host and guest programs
that make up the UMS application online system. During initialization of the application,
the control program will move the names of the programs designated in the Control Table
to the common area for later use by the application programs. The Guest and Host tables,
referred to as PCTEG and PCTEH after the name of their principal macro, vary slightly
in structure while serving the same purpose.
Program Control Table Entry Guest (PCTEG):
The PCTEG controls execution of guest side programs and LXTABLE processing.
When the user types in a UMS function code and presses enter, the Guest Side Dispatcher
(UGZ0001P) will access the PCTEG and, based on the UMS screen function code, pass
control to the appropriate guest input program (the first in the program-name list).
Following is an example of an entry in the PCTEG for UPOI:
PCTEG
“UPOI,” PGM = (UGU1011P, UGU1012P), XLATE = UGU1010T
PCTEG
The macro invocation for this entry.
UPOI
Is the UMS screen function code for this entry.
PGM=
Designates the guest program name-list.
XLATE
Names the LX table for the UPOI function.
Warning: Be certain to review the detail discussion that follows, as there are more
parameters than are shown above.
The table-driven control structure facilitates versioning of programs and functions. The
following example illustrates the steps necessary to update the PCTEG to accommodate
versioning of the UPH screen from release one to two.
Chapter Five - UMS Program Control Tables
53
Registry of Motor Vehicles – UMS Programmer’s Manual
Source Code Example - PCTEG
This example is the source for the assembled code that follows and its
hexidecimal dump.
Note: These examples have been slightly modified by text-edit to allow them to
fit in the page or to improve their readability. For brevity, some macros have a
number of parameters to show the results of expansion. Some combinations,
while assembled correctly may be illogical. Please consult the detailed write-up
for parameter usage.
UGZ0002P
NUMENT
CSECT
DC
DC
NUMXFER DC
DC
NUMALIAS DC
DC
UGZ0002Q CSECT
XFER1
EQU
UGZ0002R CSECT
ALIAS1
EQU
UGZ0002P CSECT
*
FIRST
DS
PCTEG
*
*
PCTEG
*
*
PCTEG
F'0'
A(FIRST)
F'0'
A(XFER1)
F'0'
A(ALIAS1)
NUMBER OF ENTRIES
ADDRESS OF FIRST ENTRY
NUMBER OF XFER (DUPKEY) ENTRIES
ADDRESS OF FIRST XFER ENTRY
NUMBER OF ALIAS ENTRIES
ADDRESS OF FIRST ALIAS ENTRY
*
FIRST XFER ENTRY
*
FIRST ALIAS ENTRY
0F
'ALAR',PGM=UGZ0009P,TASK=ALAR,XFER=YES
'ALAS',PGM=(UGZ0009P,XFERTEST),XFER=DATA
'LN ',PGM=(UGL0020P,UGL0021P,UGL0022P),
RESCROLL=YES,DUPKEY=LI04,ALIAS='ULN ',
XLATE=UGL0020T,UPDATE=YES,
FLAGS=FF0000000000EE11,CLEAN=CLEANPGM,
HOSTA=YES,SCROLL=YES
*
*
PCTEG
'LNO ',PGM=(UGL0240P,UGL0241P),HOSTA=YES,
RESCROLL=YES,DUPKEY=LD08,XLATE=UGL0240T,
SCROLL=YES,ALIAS='ULNO'
PCTEG
'STAT',PGM=UGZ0010P,HOSTA=NO,
FLAGS=FF00000000000000
*
*
Chapter Five - UMS Program Control Tables
54
Registry of Motor Vehicles – UMS Programmer’s Manual
*
*
PCTEG
'TPIC',PGM=(UGUI120P,UGUO120P),HOSTA=YES,
RESCROLL=YES,DUPKEY=LD18,
XLATE=UGUX120T,SCROLL=YES,
INTERNL=YES,UPDATE=YES,PF9=01
PCTEG
'TRI ',PGM=(UGRI110P,UGRO110P),
XLATE=UGRX110T,HOSTA=YES,PF4=1024,PF9=1024
PCTEG
'VER ',PGM=UGZ0032P,HOSTA=NO
DC
CSECT
EQU
CSECT
ORG
DC
ORG
DC
CLEANUP
ORG
DC
DC
END
XL4'FFFFFFFF'
*
*
*
*
*
*
LAST
UGZ0002Q
XFER2
UGZ0002P
*
FIRST XFER ENTRY
NUMENT
A((LAST-FIRST)/(SYM2-SYM1))
NUMXFER
A((XFER2-XFER1)/8)
CL8'&SYSDATE',CL1' ',CL5'&SYSTIME'
C'=VER 03.01='
Note: Change in Use for UMS
Part of the original intent of UGZ0002P was to provide a reference to all application
(3rd character of name not ‘Z’) modules required by the guest, and to require all
references to these module names to be indirect through UGZ0002P.
A decision was made for the UMS Release 5.0 to send all modules to the Insurance
Companies. Part of the reason was based on problems, which ensued when some
programmers inserted hard coded reference to module names without indirect references
through UGZ0002P with the resulting release not including adequate modules.
Therefore, there is no further need to run the program as part of the UMS Tape Release
procedure to identify programs by the TYPE parameter. However, all other uses for the
module are still very much intact with regard to PCTEG/PCTEH, which controls
execution of the programs and LXTABLE processing.
Chapter Five - UMS Program Control Tables
55
Registry of Motor Vehicles – UMS Programmer’s Manual
The PCTEG in Detail
UGZ0002P is the module also known as PCTEG, from the name of the macro used in it.
This module controls the functions that can be entered at the guest site on the screen in
the field labeled FUNCTION. This module needs to move up the “ladder” to the higher
regions as new functions are moved up for further integrated testing.
When current functions are being replaced by “new” functions, additional table entries
are needed to allow both the current and “new” function to co-exist in the same region
(This assumes that module names have changed, but function has remained the same).
For example, there is a “new” version of LI. The current entry would be used to create an
entry called TLI (the entries have to be in ascending alphabetical order). The TLI entry
would need to have the alias parameter removed if it existed. The “new” LI entry would
look like the old, except for the program name changes and any other parameter changes.
After the table changes are made, the table must be reassembled and linked into the
proper test load library.
PCTEG
<tskcode>,PGM=,TASK=,XLATE=,FLAGS=,CLEAN=,
ALIAS=,SCROLL=NO,RESCROLL=NO,UPDATE=NO,
HOSTA=NO,XFER=NO,PF4=,PF9=,PF7AND8=NO,
DUPKEY=,INTERNAL=NO,TYPE=ALL
Field Definitions
<tskcode> A 4-byte task code within quotes. PCTE entries must be sequenced
by this code. Assumed to be a test entry if the first byte is “T.”
ALIAS=<null> | <altskcode> Optional alternate task code for this function.
Same rules as name, except sequencing is not required/appropriate. It may
not duplicate any NAME parm. If ALIAS is specified, INTERNAL must
equal NO.
PGM=(<pgmlist>) 1 to 3 processing program names separated by commas. 1
name is required. A given application program may be the first program
for one non-test entry and one test entry, only.
TASK=<optaskcd> A 4-byte optional dispatch task (transaction) code (or name)
(4 ebcdic or 8 hex digits).
XLATE=<null> | <lxmodname> Name of optional map/demap translation table.
1 to 8 characters long.
Chapter Five - UMS Program Control Tables
56
Registry of Motor Vehicles – UMS Programmer’s Manual
FLAGS=<null> | <flags> An 8-byte optional flagset (expressed in hex, 16
digits) (not allowed if F4 or F9 strings present except as surrogate types).
These are available to the programs in this function and may be used to
direct processing based on the function code that invoked the program(s).
The contents are strictly application dependent.
CLEAN=<null> | <clnpgm> Name of optional tail-end cleanup program, 1 to 8
characters. If omitted the system clean-up program UGZ0005P is used. It
is normal to omit this parameter.
SCROLL=YES/NO If YES, program accepts F7/F8 and issues F9/F4.
RESCROLL=YES/NO If program has SCROLL=YES and can accept rescroll.
UPDATE=YES/NO Program accepts F12 for update
HOSTA=YES/NO
Program requires host interface area
F4=<null> | <sgcdlist> String of 1 to 4 surrogate codes allowed for F4 entry. Not
allowed if SCROLL=YES. No quotes, no commas.
F9=<null> | <sgcdlist> String of 1 to 4 surrogate codes allowed for F9 entry. Not
allowed if SCROLL=YES. No quotes, no commas.
F7AND8=YES/NO If YES, pgm accepts F7/F8 but is not a scroll pgm.
DUPKEY=<null>| <hostcd> The 4-byte host duplicate-key function associated
with this guest function. If used, HOSTA=YES is required.
INTERNL=YES/NO Is this function restricted to internal dispatch (as opposed
to user or keyboard initiated dispatch)?
TYPE=ALL | RMV This specifies if this function is applicable to all sites or just
RMV. It determines the relationship of this entry to the global assembly
options in sysparm. See the following Sysparm Option discussion.
XFER=YES/NO/DATA This directs the immediate transfer of control to a taskcode or program external to the UMS Guest system. The PGM parameter
must have UGZ0009P as the first program and HOSTA=NO. If transfer is
to a task, than TASK=<xfertask>, where <xfertask> is the transid to start,
is required. Control passes by a CICS START. If control goes to a
program (<xferpgm>) then its name will be the second value in the PGM=
parameter; ie. PGM=(UGZ0009p,<xferpgm>). Control will pass by CICS
XCTL. YES and DATA are synomonous except that the DATA option
passes a 23 byte (comm) data area. When this option is specified, the
PGM= option must specify the foreign interface module (UGZ0009P) as
Chapter Five - UMS Program Control Tables
57
Registry of Motor Vehicles – UMS Programmer’s Manual
the first program. A value must be specified for the TASK= option, and a
value may be specified for a second program name. If XFER=DATA, a
parameter-area of the following format is built by the UMS
control-dispatch mechanism for the foreign application:
bytes len
usage
00-03
04-11
12-15
16-17
18-22
ID used to sign-on to UMS
Password used to sign-on to UMS
UMS function-code entered
UMS entry-code
UMS surrogate-type and code if
F4 or F9
4
8
4
2
5
total length: 23 bytes
If control-dispatch detects that no second program-name was specified, it
starts a terminal attached transaction (taking the name from the TASK=
operand) in behalf of the terminal. If XFER=DATA was specified, the 23byte parameter-area is passed as start-data, otherwise there is none. If
control-dispatch detects that a second program-name was specified, it
XCTL's to the specified program. Only if XFER=DATA is specified, is
the 23-byte parameter-area is passed as a common-area, otherwise no
common-area is passed. The invoked transaction runs under the
transaction-id UMS was running under.
The Guest common area is freed before the transfer.
SYSPARM Options
The use of the SYSPARM option allows the creation of tailored output from the
assembly of the Program Control Table. The output can be:
1.
2.
3.
Full load module with all entries.
Load module with RMV-peculiar entries.
Generate delete control cards only.
One enters the sysparm into the standard assembly proc as follows:
CPARM2=',SYSPARM=<umstblopt>'.
where <umstblopt> may be as follows:
<umstblopt>=GENERATE_ALL
Chapter Five - UMS Program Control Tables
58
Registry of Motor Vehicles – UMS Programmer’s Manual
The full PCTEG will be generated. This is the default if no sysparm is present.
<umstblopt>=GENERATE_NOT_RMV
A partial PCTEG will be generated. All entries with TYPE=RMV will be
excluded from the generation.
<umstblopt>=PUNCH_DELETE_DSN=<data-set-name>
No PCTEG will be generated. Card images of the form:
DELETE <data-set-name>(<member-name>)
will be generated for all modules referenced on the PCTEG/TYPE= statement.
These cards may be used as IDCAMS input. This option will also raise
CONDITION-CODE=7, largely to inhibit execution of the LKED step in the
standard assembly proc.
Example:
SYSPARM=PUNCH_DELETE_DSN=RMVMV.UMS.LOADLIB
might generate, among others:
DELETE RMVMV.UMS.LOADLIB(UGZ0002P)
Chapter Five - UMS Program Control Tables
59
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Five - UMS Program Control Tables
60
Registry of Motor Vehicles – UMS Programmer’s Manual
Assembled Code Example - PCTEG
Note:
These examples have been slightly modified by text-edit to allow them to fit in the page
or to improve their readability. For brevity, some macros have a number of parameters to
show the results of expansion. Some combinations, while assembled correctly may be
illogical. Please consult the detailed write-up for parameter usage.
EXTERNAL SYMBOL DICTIONARY
SYMBOL
TYPE
UGZ0002P
UGZ0002Q
UGZ0002R
000000
000000
000004
000008
00000C
000010
000014
000218
ID
ADDR
LENGTH
LD ID FLAGS
SD 0001 000000 000215
SD 0002 000218 000018
SD 0003 000230 000010
00000000
00000018
00000000
00000218
00000000
00000230
00218
000230
00230
000018
000018
PAGE
1
ASM H V 02 11.28 07/23/91
00
00
00
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
UGZ0002P CSECT
03810000
NUMENT
DC
F'0'
NUMBER OF ENTRIES
03820000
DC
A(FIRST)
ADDRESS OF FIRST ENTRY 03830000
NUMXFER DC
F'0' NUMBER XFER (DUPKEY) ENTRIES 03840000
DC
A(XFER1)
ADDR FIRST XFER ENTRY 03850000
NUMALIAS DC
F'0'
NUMBER ALIAS ENTRIES
03860000
DC
A(ALIAS1) ADDR FIRST ALIAS ENTRY 03870000
UGZ0002Q CSECT
03880000
XFER1
EQU
*
FIRST XFER ENTRY 03890000
UGZ0002R CSECT
03900000
ALIAS1
EQU
*
FIRST ALIAS ENTRY 03910000
UGZ0002P CSECT
03920000
*
03930000
FIRST
DS
0F
03940000
PCTEG 'ALAR',PGM=UGZ0009P,
X
TASK=ALAR,XFER=YES
03950000
Chapter Five - UMS Program Control Tables
61
Registry of Motor Vehicles – UMS Programmer’s Manual
000018
000018
000020
000030
000040
000048
00004C
000054
000054
00005C
00006C
00007C
000084
000088
386+SYM1
387+
388+GST0001
389+
390+
391+
392+
393+SYM2
394 *
395 *
396
C1D3C1D9C1D3C1D9
E4C7E9F0F0F0F9D7
4040404040404040
4040404040404040
00000000
0000000000000000
C1D3C1E240404040
E4C7E9F0F0F0F9D7
4040404040404040
4040404040404040
20000000
0000000000000000
397+
398+GST0008
399+
400+
401+
402+
403 *
404 *
405
000218
000218 D3C9F0F400000090
000090
00090
000090 D3D5404040404040
000098 E4C7D3F0F0F2F0D7
0000A8 E4C7D3F0F0F2F2D7
DS
DC
DC
DC
DC
DC
DC
DS
0CL1
CL4'ALAR',CL4'ALAR'
CL8'UGZ0009P',CL8'
CL8'
',CL8'
CL8'
'
AL1(0),AL1(0),AL2(0)
XL8'0000000000000000'
0CL1
01-00282
01-00292
01-00293
01-00294
01-00295
01-00296
01-00301
01-00303
03960001
03970001
'
'
PCTEG 'ALAS',PGM=(UGZ0009P,XFERTEST),
XFER=DATA
DC
CL4'ALAS',CL4'
'
DC
CL8'UGZ0009P',CL8'XFERTEST'
DC
CL8'
',CL8'
'
DC
CL8'
'
DC
AL1(32),AL1(0),AL2(0)
DC
XL8'0000000000000000'
X
03980001
01-00292
01-00293
01-00294
01-00295
01-00296
01-00301
03990001
04000001
PCTEG 'LN ',ALIAS='ULN ',
X
PGM=(UGL0020P,UGL0021P,UGL0022P),X
RESCROLL=YES,DUPKEY=LI04,
X
XLATE=UGL0020T,UPDATE=YES,
X04030003
FLAGS=FF0000000000EE11,
X
CLEAN=CLEANPGM,
X04040002
HOSTA=YES,SCROLL=YES
04050002
406+UGZ0002Q CSECT
01-00267
407+
DC
CL4'LI04',AL4(SYM$LI04)
01-00268
408+UGZ0002P CSECT
01-00269
409+ALI0015
EQU *
01-00290
410+SYM$LI04 DC
CL4'LN ',CL4'
'
01-00292
411+PUGL0020P DC
CL8'UGL0020P',CL8'UGL0021P'
01-00293
412+
DC
CL8'UGL0022P',CL8'CLEANPGM'
01-00294
Chapter Five - UMS Program Control Tables
62
Registry of Motor Vehicles – UMS Programmer’s Manual
0000B8 E4C7D3F0F0F2F0E3
0000C0 C7000000
0000C4 FF0000000000EE11
413+
414+
415+
416 *
417 *
418
000220
000220 D3C4F0F8000000CC
0000CC
000CC
0000CC
0000D4
0000E4
0000F4
0000FC
000100
D3D5D64040404040
E4C7D3F0F2F4F0D7
4040404040404040
E4C7D3F0F2F4F0E3
C3000000
0000000000000000
000108
000110
000120
000130
000138
00013C
E2E3C1E340404040
E4C7E9F0F0F1F0D7
4040404040404040
4040404040404040
00000000
FF00000000000000
DC
DC
DC
CL8'UGL0020T'
AL1(199),AL1(0),AL2(0)
XL8'FF0000000000EE11'
PCTEG 'LNO ',PGM=(UGL0240P,UGL0241P),
HOSTA=YES,XLATE=UGL0240T,
RESCROLL=YES,DUPKEY=LD08,
SCROLL=YES,ALIAS='ULNO'
419+UGZ0002Q CSECT
420+
DC
CL4'LD08',AL4(SYM$LD08)
421+UGZ0002P CSECT
422+ALI0022
EQU *
423+SYM$LD08 DC
CL4'LNO ',CL4'
'
424+PUGL0240P DC
CL8'UGL0240P',CL8'UGL0241P'
425+
DC
CL8'
',CL8'
'
426+
DC
CL8'UGL0240T'
427+
DC
AL1(195),AL1(0),AL2(0)
428+
DC
XL8'0000000000000000'
429 *
430 *
431
PCTEG 'STAT',PGM=UGZ0010P,HOSTA=NO,
FLAGS=FF00000000000000
432+
DC
CL4'STAT',CL4'
'
433+GST0029 DC
CL8'UGZ0010P',CL8'
'
434+
DC
CL8'
',CL8'
'
435+
DC
CL8'
'
436+
DC
AL1(0),AL1(0),AL2(0)
437+
DC
XL8'FF00000000000000'
438 *
439 *
440
PCTEG 'TPIC',PGM=(UGUI120P,UGUO120P),
RESCROLL=YES,DUPKEY=LD18,
XLATE=UGUX120T,HOSTA=YES,PF9=01,
Chapter Five - UMS Program Control Tables
63
01-00295
01-00296
01-00301
04060003
04070003
X
X
X
04100003
01-00267
01-00268
01-00269
01-00290
01-00292
01-00293
01-00294
01-00295
01-00296
01-00301
04110001
04120001
X04130000
04140000
01-00292
01-00293
01-00294
01-00295
01-00296
01-00301
04150004
04160004
X
X
X
Registry of Motor Vehicles – UMS Programmer’s Manual
000228
000228
000144
000144
00014C
00015C
00016C
000174
000178
D3C4F1F800000144
E3D7C9C340404040
E4C7E4C9F1F2F0D7
4040404040404040
E4C7E4E7F1F2F0E3
D7010000
40404040F0F14040
000180
000188
000198
0001A8
0001B0
0001B4
E3D9C94040404040
E4C7D9C9F1F1F0D7
4040404040404040
E4C7D9E7F1F1F0E3
58000000
F1F0F2F4F1F0F2F4
0001BC
0001C4
0001D4
0001E4
0001EC
0001F0
E5C5D94040404040
E4C7E9F0F0F3F2D7
4040404040404040
4040404040404040
00000000
0000000000000000
0001F8 FFFFFFFF
000230
SCROLL=YES,INTERNL=YES,UPDATE=YES 04190004
01-00267
CL4'LD18',AL4(SYM$LD18)
01-00268
01-00269
CL4'TPIC',CL4'
'
01-00292
CL8'UGUI120P',CL8'UGUO120P'
01-00293
CL8'
',CL8'
'
01-00294
CL8'UGUX120T'
01-00295
AL1(215),AL1(1),AL2(0)
01-00296
CL4' ',CL4'01'
01-00298
04200001
04210001
'TRI ',PGM=(UGRI110P,UGRO110P), X
XLATE=UGRX110T,
X04220000
HOSTA=YES,PF4=1024,PF9=1024
04230000
453+
DC
CL4'TRI ',CL4'
'
01-00292
454+TUGRI110P DC
CL8'UGRI110P',CL8'UGRO110P'
01-00293
455+
DC
CL8'
',CL8'
'
01-00294
456+
DC
CL8'UGRX110T'
01-00295
457+
DC
AL1(88),AL1(0),AL2(0)
01-00296
458+
DC
CL4'1024',CL4'1024'
01-00298
459 *
04240001
460 *
04250001
461
PCTEG 'VER ',PGM=UGZ0032P,HOSTA=NO
04260000
462+
DC
CL4'VER ',CL4'
'
01-00292
463+GST0050 DC
CL8'UGZ0032P',CL8'
'
01-00293
464+
DC
CL8'
',CL8'
'
01-00294
465+
DC
CL8'
'
01-00295
466+
DC
AL1(0),AL1(0),AL2(0)
01-00296
467+
DC
XL8'0000000000000000'
01-00301
468 *
04270001
469 *
04280001
470 LAST
DC
XL4'FFFFFFFF'
04290000
471 UGZ0002Q CSECT
04300000
441+UGZ0002Q CSECT
442+
DC
443+UGZ0002P CSECT
444+SYM$LD18 DC
445+TUGUI120P DC
446+
DC
447+
DC
448+
DC
449+
DC
450 *
451 *
452
PCTEG
Chapter Five - UMS Program Control Tables
64
Registry of Motor Vehicles – UMS Programmer’s Manual
00230
0001FC
0001FC
000000 00000008
000004
000008 00000003
472 XFER2
473 UGZ0002P
474
475
476
477
478
479+UGZ0002R
480+
481+
482+ALIEND
483+UGZ0002P
484+
485+ALICOUNT
486+
487+
488
489
+
490
491
00000
00008
000230
000230 E4D3D54000000090
000238 E4D3D5D6000000CC
00240
00000C
00000C
00010
00002
000010 00000002
000014
0001FC
001FC
001FC
0001FC F0F761F2F361F9F1
00020A 7EE5C5D940F0F34B
EQU
*
FIRST XFER ENTRY 04310000
CSECT
04320000
ORG
NUMENT
04330000
DC
A((LAST-FIRST)/(SYM2-SYM1))
04340000
ORG
NUMXFER
04350000
DC
A((XFER2-XFER1)/8)
04360000
CLEANUP
04370000
CSECT
01-00350
DC
CL4'ULN ',AL4(ALI0015)
01-00351
DC
CL4'ULNO',AL4(ALI0022)
01-00360
EQU
*
01-00363
CSECT
01-00364
ORG
NUMALIAS
01-00365
EQU
(ALIEND-ALIAS1)/8
01-00366
DC
AL4(ALICOUNT)
01-00367
ORG
01-00368
ORG
04380000
DC
CL8'&SYSDATE',CL1' ',CL5'&SYSTIME'04390000
DC
CL8'07/23/91',CL1' ',CL5'11.28'
04390000
DC
C'=VER 03.01='
04400000
END
04410000
RELOCATION DICTIONARY
POS.ID
0001
0001
0001
0002
0002
0002
0003
0003
REL.ID
0001
0002
0003
0001
0001
0001
0001
0001
FLAGS
0C
0C
0C
0C
0C
0C
0C
0C
ADDRESS
000004
00000C
000014
00021C
000224
00022C
000234
00023C
PAGE
11
ASM H V 02 11.28 07/23/91
DIAGNOSTIC CROSS REFERENCE AND ASSEMBLER SUMMA
Chapter Five - UMS Program Control Tables
65
Registry of Motor Vehicles – UMS Programmer’s Manual
NO STATEMENTS FLAGGED IN THIS ASSEMBLY
OVERRIDING PARAMETERS- LIST,NODECK,LOAD,LINECOUNT(65)
OPTIONS FOR THIS ASSEMBLY
NODECK, OBJECT, LIST, XREF(FULL), NORENT, NOTEST, NOBATCH, ALIGN, ESD, RLD,NOTERM, NODBCS,
LINECOUNT(65), FLAG(0), SYSPARM()
NO OVERRIDING DD NAMES
433 CARDS FROM SYSIN
0 CARDS FROM SYSLIB
584 LINES OUTPUT
23 CARDS OUTPUT
MVS/XA DFP VER 2 LINKAGE EDITOR
JOB RMCJEBBE
STEP STEP010
PROCEDURE LKED
INVOCATION PARAMETERS - LIST,XREF
ACTUAL SIZE=(317440,79872)
OUTPUT DATA SET IS ON VOLUME RELP02
11:28:44
TUE
JUL 23, 1991
CROSS REFERENCE TABLE
CONTROL SECTION
NAME
ORIGIN
UGZ0002P
00
UGZ0002Q
218
UGZ0002R
230
LOCATION
SECTION
C
21C
22C
23C
LENGTH
215
18
10
REFERS TO SYMBOL
ENTRY ADDRESS
TOTAL LENGTH
UGZ0002Q
UGZ0002P
UGZ0002P
UGZ0002P
ENTRY
NAME
IN CONTROL SECTION
UGZ0002Q
UGZ0002P
UGZ0002P
UGZ0002P
LOCATION
NAME
LOCATION
LOCATION
REFERS TO
14
224
234
SYMBOL
UGZ0002R
UGZ0002P
UGZ0002P
00
240
Chapter Five - UMS Program Control Tables
IN CONTROL
66
UGZ0002R
UGZ0002P
UGZ0002P
Registry of Motor Vehicles – UMS Programmer’s Manual
** TST0002P REPLACED AND HAS AMODE 24
** LOAD MODULE HAS RMODE 24
** AUTHORIZATION CODE IS
0.
Chapter Five - UMS Program Control Tables
67
Registry of Motor Vehicles – UMS Programmer’s Manual
Hexidecimal Dump of PCTEG Example
AMASPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
DUMPT TST0002P ALL
00110005
**CCHHR- 0011000419
RECORD LENGTH- 000240
000000
00000008 00000018 00000003 00000218
000020
E4C7E9F0 F0F0F9D7 40404040 40404040
000040
40404040 40404040 00000000 00000000
000060
F0F0F9D7 E7C6C5D9 E3C5E2E3 40404040
000080
40404040 20000000 00000000 00000000
0000A0
E4C7D3F0 F0F2F1D7 E4C7D3F0 F0F2F2D7
0000C0
C7000000 FF000000 0000EE11 D3D5D640
0000E0
F2F4F1D7 40404040 40404040 40404040
000100
00000000 00000000 E2E3C1E3 40404040
000120
40404040 40404040 40404040 40404040
000140
00000000 E3D7C9C3 40404040 E4C7E4C9
000160
40404040 40404040 40404040 E4C7E4E7
MEMBER NAME TST0002P CSECT NAME UGZ0002P
00000002 00000230 C1D3C1D9 C1D3C1D9 *................*
*........ALARALAR*
40404040 40404040 40404040 40404040 *UGZ0009P
*
*
*
00000000 C1D3C1E2 40404040 E4C7E9F0 *
........*
*....ALAS
UGZ0*
40404040 40404040 40404040 40404040 *009PXFERTEST
*
*
*
D3D54040 40404040 E4C7D3F0 F0F2F0D7 *
............*
*LN
UGL0020P*
C3D3C5C1 D5D7C7D4 E4C7D3F0 F0F2F0E3 *UGL0021PUGL0022P*
*CLEANPGMUGL0020T*
40404040 E4C7D3F0 F2F4F0D7 E4C7D3F0 *G...........LNO *
*
UGL0240PUGL0*
40404040 E4C7D3F0 F2F4F0E3 C3000000 *241P
*
*
UGL0240TC...*
E4C7E9F0 F0F1F0D7 40404040 40404040 *........STAT
*
*UGZ0010P
*
40404040 40404040 00000000 FF000000 *
*
*
........*
F1F2F0D7 E4C7E4D6 F1F2F0D7 40404040 *....TPIC
UGUI*
*120PUGUO120P
*
F1F2F0E3 D7010000 40404040 F0F14040 *
UGUX*
*120TP...
01 *
Chapter Five - UMS Program Control Tables
68
Registry of Motor Vehicles – UMS Programmer’s Manual
000180
E3D9C940 40404040 E4C7D9C9 F1F1F0D7
0001A0
40404040 40404040 E4C7D9E7 F1F1F0E3
0001C0
40404040 E4C7E9F0 F0F3F2D7 40404040
0001E0
40404040 40404040 40404040 00000000
000200
F361F9F1 40F1F14B F2F87EE5 C5D940F0
**CCHHR- 0011000419
RECORD LENGTH- 000240
000000
D3C9F0F4 00000090 D3C4F0F8 000000CC
**CCHHR- 0011000419
RECORD LENGTH- 000240
E4C7D9D6 F1F1F0D7 40404040 40404040 *TRI
UGRI110P*
*UGRO110P
*
58000000 F1F0F2F4 F1F0F2F4 E5C5D940 *
UGRX110T*
*....10241024VER *
40404040 40404040 40404040 40404040 *
UGZ0032P
*
*
*
00000000 00000000 FFFFFFFF F0F761F2 *
....*
*............07/2*
F34BF0F1 7E
*3/91 11.28=VER 0*
*3.01=
*
MEMBER NAME TST0002P
D3C4F1F8 00000144
MEMBER NAME
TST0002P
CSECT NAME UGZ0002Q
*LI04....LD08....*
*LD18....
*
CSEC
NAME UGZ0002R
000000
E4D3D540 00000090 E4D3D5D6 000000CC
NAME
UGZ0002R
*ULN ....ULNO....*
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I AMASPZAP PROCESSING COMPLETED
***************************** BOTTOM OF DATA*****************************************************
Chapter Five - UMS Program Control Tables
69
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Five - UMS Program Control Tables
70
Registry of Motor Vehicles – UMS Programmer’s Manual
Program Control Table Entry Host (PCTEH)
The PCTEH controls execution of the host side programs, service modules, and duplicate
resolution modules. When control is passed from the guest side to the host side, C&C’s
Host Side Dispatcher (UHZ0001P) accesses the PCTEH. The internal function code
(refer to Internal Function Codes section for more detail) passes control to the appropriate
host input program. UHZ0001P will move the names of all host side programs, service
modules, and duplicate resolution modules to the common area for later use by the guest
side programs. If the Host processing receives anything other than a surrogate key, the
first program in the <name-list> will try to convert it into a unique surrogate key. If none
is found, an error is returned. If only one is found, processing will pass to the second
program in the <name-list>. If 2 or more are found, the duplicate resolver transaction
will be invoked to provide scroll data and return to the Guest.
The SERVICE macro defines groups of service program names so that a simple reference
in the PCTEH macro will allow the task being defined access to that set of service
modules. The form is:
SERVICE <name>,PGM=(<name-list>)
<name>
a 1 or 2 digit identifier for this service set.
<name-list>
1 to 8 service program names. 1 required. Need not be the
first.
The PCTEH macro has a similar function to the PCTEG macro on the Guest side. That
is, it defines the task codes that may be used, the programs that may be invoked for each
one along with some additional information. They are assembled and linked as a table
(load module) that is accessed by UHZ0001P, the HOST Control/Dispatch Program to
manage the system. The form of the macro is as follows:
PCTEH <tskcode>,PGM=,TASK=,RMV=,FLAGS=,
CLEAN=,DUPKEY=,SERVICE=
Field Definitions
<tskcode> A 4-byte block type or task code. PCTEG entries must be sequenced
by this code. Only alpha-numeric values may be used.
PGM=<pgmlist> 1 to 3 processing program names. 1 REQUIRED.
Chapter Five - UMS Program Control Tables
71
Registry of Motor Vehicles – UMS Programmer’s Manual
TASK=<null> | <optaskcd> A 4-byte optional dispatch task (transaction) code.
RMV=<alfuncn> An ALARS equivalent function-name (for security mapping)
FLAGS=<null> | <flags> An 8-byte optional flagset (expressed in hex) These are
available to the application programs for this function. They may be used
to direct processing based on the function code invoking the program(s).
CLEAN=<null> | <clnpgm> The Name of an optional tail-end cleanup program.
DUPKEY=<null> | <hostcd> A 4-byte optional host block-type or task code used
for resolution of duplicate keys detected during this invocation. Note that
specification of a non-existent entry will result in undefined symbols of
the form BTC$XXXX where XXXX is the block type or transaction code.
SERVICE=<null> | <srvcset> The optional 1 or 2 digit identifier of a defined
service set, established by a SERVICE macro, used by this function.
Following is an example of an entry in the PCTEH for UPOI:
PCTEH
UU11,PGM=(UHU3013P,UHU3014P),RMV=POI,
DUPKEY=LD08,SERVICE=5
PCTEH
Indicates the beginning of a table entry.
UU11
Used by UHZ0001P to determine which table entry to reference
based on the internal function code passed by the guest input
program. 'UU11' is one of the internal function codes used in the
guest input program for UPOI.
PGM
Refers to the host input and output program names.
RMV
Used for mapping security features from the ALARS equivalent
screen (POI) to UPOI.
DUPKEY
Refers to duplicate resolution modules. In this case, 'LD08'
references the license duplicate resolution module.
SERVICE
Used to indicate that the service modules UHU101CP,
UHU1SDIP, and UHL0055P are available to the UPOI host
programs.
Chapter Five - UMS Program Control Tables
X
72
Registry of Motor Vehicles – UMS Programmer’s Manual
Control tables allow the UMS online system flexibility to maintain two versions of the
application at any given time (refer to the Versioning and Naming Standards section for
more detail). Each time versioning is applied to an online UMS screen, it will be
necessary to update the PCTEG and PCTEH.
When current functions are being replaced by “new” functions or “new” functions are
just being added, the “new” functions are entered to allow both the current and “new”
function to co-exist in the same region. For example there is a “new” version of Pers
look-up by Mass. license number. The current entry (LI07) would remain untouched.
The “new” entry would be called LI20 (Remember, the entries have to be in ascending
alphabetical order). The “new” LI20 entry would look like the old except for the
program name changes and any other parameter changes.
Chapter Five - UMS Program Control Tables
73
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Five - UMS Program Control Tables
74
Registry of Motor Vehicles – UMS Programmer’s Manual
Source Code Example - PCTEH
UHZ0002P CSECT
NUMENT
DC
F'0'
NUMBER OF ENTRIES
DC
A(FIRST)
POINT TO 1ST ENTRY
SERVICE 1,PGM=(UHRSTTLS,UHRSREGS)
SERVICE 2,PGM=(UHUC101P,UHUSSDIP,UHL0050P)
SERVICE 3,PGM=(UHRSREGS,UHL0050P)
* NDR/ESI ROUTING TABLE:
SERVICE 4,PGM=(UHL0200P)
SERVICE 5,PGM=(UHU101CP,MMRSSDIP,UHL0055P)
SERVICE 6,PGM=(UHL0055P,UHL0065P)
SPACE 3
*
* TABLE LOAD FUNCTION:
PCTEH HTB1,PGM=(UHZ0004P)
PCTEH HTB2,PGM=(UHZ0004P,MRMXWAFL)
SPACE 3
* GENERALIZED FETCHER OF BREFS:
PCTEH LB10,PGM=(UHL0420P),RMV=LI,CLEAN=TSTCLEAN
SPACE 3
* DUPLICATE SSN SCROLL
PCTEH LD04,PGM=(UHL0500P),RMV=LP
SPACE 3
* LICENSE HISTORY LOOK-UP BY LICENSE #
PCTEH LH10,PGM=(UHL0070P,UHL0060P),
RMV=LI,DUPKEY=LI04
SPACE 3
Chapter Five - UMS Program Control Tables
KK0191
SC0890
0261000
0262000
0263000
0264000
0265000
0266000
0267000
0268000
0269000
0269100
0269110
0269200
0269210
0269230
0269240
0269270
0269280
0269290
0269300
0269310
0269400
0269600
0269700
X0269800
0269900
0269910
75
Registry of Motor Vehicles – UMS Programmer’s Manual
* LICENSE NUMBER SCROLL
0269920
PCTEH LI04,PGM=(UHL0020P),
X0269931
RMV=LP
0269940
SPACE 3
0270000
* LICENSE INQUIRY (BY LIC. NUMBER) (NEW)
0275000
PCTEH LI07,PGM=(UHL0070P,UHL0100P,UHL0110P),SERVICE=6,
X0276000
RMV=LI,DUPKEY=LI04,FLAGS=0003000000000000,
X0277001
CLEAN=TSTCLEAN
0288100
SPACE 3
0288200
* LXGHOST INQUIRE_NDR
0298000
PCTEH LX51,PGM=(UHL0300P,UHLNDR1P,UHL0400P),SERVICE=4,RMV=LX, X0299000
FLAGS=8000000000000000
0300000
SPACE 3
0301000
* LX-WRITE OVERRIDE BREF: (1ST 2 FLAG BYTES=SUBFUNCTION SECURITY)
0306000
PCTEH LX70,PGM=(UHL0260P,UHL0400P),SERVICE=4,RMV=LX,
X0307000
FLAGS=C440000000000000
0308000
SPACE 3
0309000
LAST
DC
XL4'FFFFFFFF'
0341000
ORG
NUMENT
0342000
DC
A((LAST-FIRST)/(SYM2-SYM1))
0343000
ORG
0344000
DC
CL8'&SYSDATE',CL1' ',CL5'&SYSTIME'
0345000
END
0346000
******************************** BOTTOM OF DATA *******************************
Chapter Five - UMS Program Control Tables
76
Registry of Motor Vehicles – UMS Programmer’s Manual
Assembled Code Example - PCTEH
Note: These examples have been slightly modified by text-edit to allow them to fit in the page
or to improve their readability. For brevity, some macros have a number of parameters to
show the results of expansion. Some combinations, while assembled correctly may be
illogical. Please consult the detailed write-up for parameter usage.
UHZ0002P - UMS HOST PROCESS-CONTROL TABLE
LOC OBJECT CODE
ADDR1 ADDR2 STMT
SOURCE STATEMENT
000000
000000 00000000
000004 00000188
000008
000018
000028
000038
E4C8D9E2E3E3D3E2
4040404040404040
4040404040404040
4040404040404040
000048
000058
000068
000078
E4C8E4C3F1F0F1D7
E4C8D3F0F0F5F0D7
4040404040404040
4040404040404040
000088
000098
0000A8
0000B8
E4C8D9E2D9C5C7E2
4040404040404040
4040404040404040
4040404040404040
PAGE
6
ASM H V 02 15.16 07/15/91
260 UHZ0002P CSECT
261 NUMENT
DC
F'0'
NUMBER OF ENTRIES
262
DC
A(FIRST)
POINT TO 1ST ENTRY
263
SERVICE 1,PGM=(UHRSTTLS,UHRSREGS)
264+SRV#1
DC
CL8'UHRSTTLS',CL8'UHRSREGS'
265+
DC
CL8'
',CL8'
'
266+
DC
CL8'
',CL8'
'
267+
DC
CL8'
',CL8'
'
268
SERVICE 2,PGM=(UHUC101P,UHUSSDIP,UHL0050P)
269+SRV#2
DC
CL8'UHUC101P',CL8'UHUSSDIP'
270+
DC
CL8'UHL0050P',CL8'
'
271+
DC
CL8'
',CL8'
'
272+
DC
CL8'
',CL8'
'
273
SERVICE 3,PGM=(UHRSREGS,UHL0050P)
274+SRV#3
DC
CL8'UHRSREGS',CL8'UHL0050P'
275+
DC
CL8'
',CL8'
'
276+
DC
CL8'
',CL8'
'
277+
DC
CL8'
',CL8'
'
278 * NDR/ESI ROUTING TABLE:
Chapter Five - UMS Program Control Tables
77
02610000
02620000
02630000
02640000
01-00254
01-00255
01-00256
01-00257
02650000
01-00254
01-00255
01-00256
01-00257
02660000
01-00254
01-00255
01-00256
01-00257
02670000
Registry of Motor Vehicles – UMS Programmer’s Manual
0000C8
0000D8
0000E8
0000F8
E4C8D3F0F2F0F0D7
4040404040404040
4040404040404040
4040404040404040
000108
000118
000128
000138
E4C8E4F1F0F1C3D7
E4C8D3F0F0F5F5D7
4040404040404040
4040404040404040
000148
000158
000168
000178
E4C8D3F0F0F5F5D7
4040404040404040
4040404040404040
4040404040404040
000188
IEV254 *** MNOTE ***
000188
000188 C8E3C2F140404040
000190 4040404040400000
00019E E4C8E9F0F0F0F4D7
0001AE 4040404040404040
0001BE 0000000000000000
0001C6
IEV254 *** MNOTE ***
0001C6 C8E3C2F240404040
279
280+SRV#4
281+
282+
283+
284
285+SRV#5
286+
287+
288+
289
290+SRV#6
291+
292+
293+
SERVICE
DC
DC
DC
DC
SERVICE
DC
DC
DC
DC
SERVICE
DC
DC
DC
DC
4,PGM=(UHL0200P)
CL8'UHL0200P',CL8'
'
CL8'
',CL8'
'
CL8'
',CL8'
'
CL8'
',CL8'
'
5,PGM=(UHU101CP,MMRSSDIP,UHL0055P)
CL8'UHU101CP',CL8'MMRSSDIP'
CL8'UHL0055P',CL8'
'
CL8'
',CL8'
'
CL8'
',CL8'
'
6,PGM=(UHL0055P,UHL0065P)
CL8'UHL0055P',CL8'UHL0065P'
CL8'
',CL8'
'
CL8'
',CL8'
'
CL8'
',CL8'
'
295 *
296 * TABLE LOAD FUNCTION:
297
PCTEH HTB1,PGM=(UHZ0004P)
298+FIRST
DS
0F
ORIGIN OF FIRST ENTRY
299+
4,WARNING - THIS FUNCTION WILL BE UNSECURED
300+SYM1
DS
0CL1
301+BTC$HTB1 DC
CL4'HTB1',CL4'
'
302+
DC
CL6'
',XL8'0000000000000000'
303+
DC
CL8'UHZ0004P',CL8'
'
304+
DC
CL8'
',CL8'
'
305+
DC
XL4'0',AL4(0)
306+SYM2
DS
0CL1
307
PCTEH HTB2,PGM=(UHZ0004P,MRMXWAFL)
308+
4,WARNING - THIS FUNCTION WILL BE UNSECURED
309+BTC$HTB2 DC
CL4'HTB2',CL4'
'
Chapter Five - UMS Program Control Tables
78
02680000
01-00254
01-00255
01-00256
01-00257
690005
01-00254
01-00255
01-00256
01-00257
691000
01-00254
01-00255
01-00256
01-00257
02692000
02692106
02692300
02692400
01-00052
01-00157
01-00159
01-00160
01-00161
01-00162
01-00163
01-00165
02692400
01-00052
01-00159
Registry of Motor Vehicles – UMS Programmer’s Manual
0001CE
0001DC
0001EC
0001FC
000204
00020C
00021A
00022A
LOC
4040404040400000
E4C8E9F0F0F0F4D7
4040404040404040
0000000000000000
310+
311+
312+
313+
DC
DC
DC
DC
CL6'
',XL8'0000000000000000'
CL8'UHZ0004P',CL8'MRMXWAFL'
CL8'
',CL8'
'
XL4'0',AL4(0)
D3C2F1F040404040
D3C9404040400000
E4C8D3F0F4F2F0D7
4040404040404040
315 * GENERALIZED FETCHER OF BREFS:
02692800
316
PCTEH LB10,PGM=(UHL0420P),RMV=LI,CLEAN=TSTCLEAN
317+BTC$LB10 DC
CL4'LB10',CL4'
'
01-00159
318+
DC
CL6'LI',XL8'0000000000000000'
01-00160
319+
DC
CL8'UHL0420P',CL8'
'
01-00161
320+
DC
CL8'
',CL8'TSTCLEAN'
01-00162
UHZ0002P - UMS HOST PROCESS-CONTROL TABLE
OBJECT CODE
ADDR1 ADDR2 STMT
SOURCE STATEMENT
PAGE
7
ASM H V 02 15.16 07/15/91
00023A 0000000000000000
321+
000242
00024A
000258
000268
000278
323 * DUPLICATE SSN SCROLL
324
PCTEH LD04,PGM=(UHL0500P),RMV=LP
325+BTC$LD04 DC
CL4'LD04',CL4'
'
326+
DC
CL6'LP',XL8'0000000000000000'
327+
DC
CL8'UHL0500P',CL8'
'
328+
DC
CL8'
',CL8'
'
329+
DC
XL4'0',AL4(0)
D3C4F0F440404040
D3D7404040400000
E4C8D3F0F5F0F0D7
4040404040404040
0000000000000000
002BE
000280 D3C8F1F040404040
000288 D3C9404040400000
000296 E4C8D3F0F0F7F0D7
DC
01-00160
01-00161
01-00162
01-00163
XL4'0',AL4(0)
01-00163
02693100
02694000
01-00159
01-00160
01-00161
01-00162
01-00163
331 * LICENSE HISTORY LOOK-UP BY LICENSE #
02697000
332
PCTEH LH10,PGM=(UHL0070P,UHL0060P),
02698000
RMV=LI,DUPKEY=LI04
02699000
333+CHK$LI040011 EQU BTC$LI04 "UNDEFINED" ERROR IF UNKN TYPE
334+BTC$LH10 DC
CL4'LH10',CL4'
'
01-00159
335+
DC
CL6'LI',XL8'0000000000000000'
01-00160
336+
DC
CL8'UHL0070P',CL8'UHL0060P'
01-00161
Chapter Five - UMS Program Control Tables
79
Registry of Motor Vehicles – UMS Programmer’s Manual
0002A6 4040404040404040
0002B6 D3C9F0F400000000
337+
338+
0002BE
0002C6
0002D4
0002E4
0002F4
D3C9F0F440404040
D3D7404040400000
E4C8D3F0F0F2F0D7
4040404040404040
0000000000000000
340 * LICENSE NUMBER SCROLL
341
PCTEH LI04,PGM=(UHL0020P),
RMV=LP
342+BTC$LI04 DC
CL4'LI04',CL4'
'
343+
DC
CL6'LP',XL8'0000000000000000'
344+
DC
CL8'UHL0020P',CL8'
'
345+
DC
CL8'
',CL8'
'
346+
DC
XL4'0',AL4(0)
D3C9F0F740404040
D3C9404040400003
E4C8D3F0F0F7F0D7
E4C8D3F0F1F1F0D7
D3C9F0F400000148
348 * LICENSE INQUIRY (BY LIC. NUMBER) (NEW)
02750000
349
PCTEH LI07,PGM=(UHL0070P,UHL0100P,UHL0110P),
SERVICE=6,RMV=LI,DUPKEY=LI04,
X02760000
FLAGS=0003000000000000,
X02770011
CLEAN=TSTCLEAN
02881006
350+CHK$LI040013 EQU BTC$LI04 "UNDEFINED" ERROR IF UNKN TYPE
351+BTC$LI07 DC
CL4'LI07',CL4'
'
01-00159
352+
DC
CL6'LI',XL8'0003000000000000'
01-00160
353+
DC
CL8'UHL0070P',CL8'UHL0100P'
01-00161
354+
DC
CL8'UHL0110P',CL8'TSTCLEAN'
01-00162
355+
DC
CL4'LI04',AL4(SRV#6)
01-00163
D3E7F5F140404040
D3E7404040408000
E4C8D3F0F3F0F0D7
E4C8D3F0F4F0F0D7
357 * LXGHOST INQUIRE_NDR
02980000
358
PCTEH LX51,PGM=(UHL0300P,UHLNDR1P,UHL0400P),
SERVICE=4,RMV=LX,
X02990000
FLAGS=8000000000000000
03000000
359+BTC$LX51 DC
CL4'LX51',CL4'
'
01-00159
360+
DC
CL6'LX',XL8'800000000000 000'
01-00160
361+
DC
CL8'UHL0300P',CL8'UHLNDR1P'
01-00161
362+
DC
CL8'UHL0400P',CL8'
'
01-00162
002BE
0002FC
000304
000312
000322
000332
00033A
000342
000350
000360
DC
DC
CL8'
',CL8'
CL4'LI04',AL4(0)
Chapter Five - UMS Program Control Tables
'
80
01-00162
01-00163
02699209
02699310
02699409
01-00159
01-00160
01-00161
01-00162
01-00163
Registry of Motor Vehicles – UMS Programmer’s Manual
000370 00000000000000C8
363+
000378 D3E7F7F040404040
365 * LX-WRITE OVERRIDE BREF:
*
(1ST 2 FLAG BYTES=SUBFUNCTION SECURITY)
366
PCTEH LX70,PGM=(UHL0260P,UHL0400P),
SERVICE=4,RMV=LX,
FLAGS=C440000000000000
367+BTC$LX70 DC
CL4'LX70',CL4'
'
LOC
DC
XL4'0',AL4(SRV#4)
UHZ0002P - UMS HOST PROCESS-CONTROL TABLE
OBJECT CODE
ADDR1 ADDR2 STMT
SOURCE STATEMENT
01-00163
368+
DC
CL6'LX',XL8'C440000000000000'
369+
DC
CL8'UHL0260P',CL8'UHL0400P'
370+
DC
CL8'
371+
DC
XL4'0',AL4(SRV#4)
0003B6 FFFFFFFF
03410000
0003BA
03420000
000000 00000009
03430000
000004
03440000
373 LAST
DC
XL4'FFFFFFFF'
374
ORG
NUMENT
375
DC
A((LAST-FIRST)/(SYM2-SYM1))
376
ORG
377
DC
003BA
',CL8'
'
CL8'&SYSDATE',CL1' ',CL5'&SYSTIME'
03450000
Chapter Five - UMS Program Control Tables
X03070000
03080000
01-00159
PAGE
8
ASM H V 02 15.16 07/15/91
000380 D3E740404040C440
01-00160
00038E E4C8D3F0F2F6F0D7
01-00161
00039E 4040404040404040
01-00162
0003AE 00000000000000C8
01-00163
00000
03060000
81
Registry of Motor Vehicles – UMS Programmer’s Manual
0003BA F0F761F1F561F9F1
03450000
+
DC
378
CL8'07/15/91',CL1' ',CL5'15.16'
END
03460000
RELOCATION DICTIONARY
POS.ID
0001
0001
0001
0001
REL.ID
0001
0001
0001
0001
FLAGS
0C
0C
0C
0C
ADDRESS
000004
000336
000374
0003B2
LINECOUNT(65), FLAG(0), SYSPARM()
NO OVERRIDING DD NAMES
310 CARDS FROM SYSIN
0 CARDS FROM SYSLIB
452 LINES OUTPUT
23 CARDS OUTPUT
MVS/XA DFP VER 2 LINKAGE EDITOR
JOB RMCJEBBH
STEP STEP010
PROCEDURE LKED
INVOCATION PARAMETERS - LIST,XREF
ACTUAL SIZE=(317440,79872)
OUTPUT IS ON VOLUME RELP02
15:16:22
MON
JUL 15, 1991
CROSS REFERENCE TABLE
CONTROL SECTION
NAME
ORIGIN
UHZ0002P
00
LOCATION
LENGTH
3C8
REFERS TO SYMBOL
ENTRY
NAME
IN CONTROL SECTION
LOCATION
NAME
LOCATION
LOCATION
Chapter Five - UMS Program Control Tables
REFERS TO
82
Registry of Motor Vehicles – UMS Programmer’s Manual
ENTRY ADDRESS
NAME
LOCATION
00
NAME
LOCATION
SYMBOL IN CONTROL SECTION
** UHZ0002P REPLACED AND HAS AMODE 24
** LOAD MODULE HAS RMODE 24
** AUTHORIZATION CODE IS
0.
***************************** BOTTOM OF DATA *****************************
Chapter Five - UMS Program Control Tables
83
Registry of Motor Vehicles – UMS Programmer’s Manual
Hexidecimal Dump of PCTEH Example
AMASPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
DUMPT UHZ0002P ALL
00110006
**CCHHR- 0011000401
RECORD LENGTH- 0003C8
000000
00000009 00000188 E4C8D9E2 E3E3D3E2
000020
40404040 40404040 40404040 40404040
000040
40404040 40404040 E4C8E4C3 F1F0F1D7
000060
40404040 40404040 40404040 40404040
000080
40404040 40404040 E4C8D9E2 D9C5C7E2
0000A0
40404040 40404040 40404040 40404040
0000C0
40404040 40404040 E4C8D3F0 F2F0F0D7
0000E0
40404040 40404040 40404040 40404040
000100
40404040 40404040 E4C8E4F1 F0F1C3D7
000120
40404040 40404040 40404040 40404040
000140
40404040 40404040 E4C8D3F0 F0F5F5D7
000160
40404040 40404040 40404040 40404040
000180
40404040 40404040 C8E3C2F1 40404040
MEMBER NAME UHZ0002P CSECT NAME UHZ0002P
E4C8D9E2 D9C5C7E2 40404040 40404040 *........UHRSTTLS*
*UHRSREGS
*
40404040 40404040 40404040 40404040 *
*
*
*
E4C8E4E2 E2C4C9D7 E4C8D3F0 F0F5F0D7 *
UHUC101P*
*UHUSSDIPUHL0050P*
40404040 40404040 40404040 40404040 *
*
*
*
E4C8D3F0 F0F5F0D7 40404040 40404040 *
UHRSREGS*
*UHL0050P
*
40404040 40404040 40404040 40404040 *
*
*
*
40404040 40404040 40404040 40404040 *
UHL0200P*
*
*
40404040 40404040 40404040 40404040 *
*
*
*
D4D4D9E2 E2C4C9D7 E4C8D3F0 F0F5F5D7 *
UHU101CP*
*MMRSSDIPUHL0055P*
40404040 40404040 40404040 40404040 *
*
*
*
E4C8D3F0 F0F6F5D7 40404040 40404040 *
UHL0055P*
*UHL0065P
*
40404040 40404040 40404040 40404040 *
*
*
*
40404040 40400000 00000000 0000E4C8 *
HTB1
*
*
........UH*
Chapter Five - UMS Program Control Tables
84
Registry of Motor Vehicles – UMS Programmer’s Manual
0001A0
E9F0F0F0 F4D74040 40404040 40404040
40404040 40404040 40404040 40400000
0001C0
00000000 0000C8E3 C2F24040 40404040
40404040 00000000 00000000 E4C8E9F0
0001E0
F0F0F4D7 D4D9D4E7 E6C1C6D3 40404040
40404040 40404040 40404040 00000000
000200
00000000 D3C2F1F0 40404040 D3C94040
40400000 00000000 0000E4C8 D3F0F4F2
000220
F0D74040 40404040 40404040 40404040
4040E3E2 E3C3D3C5 C1D50000 00000000
000240
0000D3C4 F0F44040 4040D3D7 40404040
00000000 00000000 E4C8D3F0 F5F0F0D7
000260
40404040 40404040 40404040 40404040
40404040 40404040 00000000 00000000
000280
D3C8F1F0 40404040 D3C94040 40400000
00000000 0000E4C8 D3F0F0F7 F0D7E4C8
0002A0
D3F0F0F6 F0D74040 40404040 40404040
40404040 4040D3C9 F0F40000 0000D3C9
0002C0
F0F44040 4040D3D7 40404040 00000000
00000000 E4C8D3F0 F0F2F0D7 40404040
0002E0
40404040 40404040 40404040 40404040
40404040 00000000 00000000 D3C9F0F7
000300
40404040 D3C94040 40400003 00000000
0000E4C8 D3F0F0F7 F0D7E4C8 D3F0F1F0
000320
F0D7E4C8 D3F0F1F1 F0D7E3E2 E3C3D3C5
C1D5D3C9 F0F40000 0148D3E7 F5F14040
000340
4040D3E7 40404040 80000000 00000000
E4C8D3F0 F3F0F0D7 E4C8D3D5 C4D9F1D7
000360
E4C8D3F0 F4F0F0D7 40404040 40404040
00000000 000000C8 D3E7F7F0 40404040
000380
D3E74040 4040C440 00000000 0000E4C8
D3F0F2F6 F0D7E4C8 D3F0F4F0 F0D74040
0003A0
40404040 40404040 40404040 40400000
00000000 00C8FFFF FFFFF0F7 61F1F561
0003C0
F9F140F1 F54BF1F6
Chapter Five - UMS Program Control Tables
*Z0004P
*
*
..*
*......HTB2
*
*
........UHZ0*
*004PMRMXWAFL
*
*
....*
*....LB10
LI *
* ........UHL042*
*0P
*
* TSTCLEAN......*
*..LD04
LP
*
*........UHL0500P*
*
*
*
........*
*LH10
LI
..*
*......UHL0070PUH*
*L0060P
*
*
LI04....LI*
*04
LP
....*
*....UHL0020P
*
*
*
*
........LI07*
*
LI
......*
*..UHL0070PUHL010*
*0PUHL0110PTSTCLE*
*ANLI04....LX51 *
* LX
........*
*UHL0300PUHLNDR1P*
*UHL0400P
*
*.......HLX70
*
*LX
D ......UH*
*L0260PUHL0400P *
*
..*
*.....H....07/15/*
*91 15.16
*
85
Registry of Motor Vehicles – UMS Programmer’s Manual
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I AMASPZAP PROCESSING COMPLETED
******************************** BOTTOM OF DATA ********************************
Chapter Five - UMS Program Control Tables
86
Registry of Motor Vehicles – UMS Programmer’s Manual
Internal Function Codes
UMS internal function codes are used by the Host Side Dispatcher program (UHZ0001P)
to indicate which host programs, service modules, and duplicate resolution modules to
invoke. The guest input program is responsible for determining which internal function
code is needed and moving it to the appropriate displacement in the guest-to-host block
of the common area. When control passes to the host side, UHZ0001P matches the
internal function code within the guest-to-host block of the common area to the internal
function code in the Program Control Table Entry Host table (PCTEH; refer to the
Program Control Table section for more detail) to determine which host program to
execute.
Each online UMS screen has two sets of internal function codes. One set is used with the
current version of the guest and host software and the other set is available for the next
version or release of software (refer to the Versioning and Naming Standards sections for
more detail). In other words, each time versioning is applied to an online UMS screen,
the application programmer alternates between the function codes listed in the columns
below.
For example, if UPIC is versioned and the current Guest Input program references
“UU14” and “UU15,” the new versioned Guest Input program would reference “UU06”
and “UU07.”
The UPH screen is another example of a screen that employs two function codes at once.
On the UPH screen, policy history information may be requested using either an in-state
or an out-of-state license number as a key. Currently, if a request is performed using an
in-state license, the Guest Input program (UGU3041P) will move a “UU08” to the guestto-host block of the common area. For an out-of-state license request, “UU09” will be
moved to the guest-to-host block of the common area. The next time UPH is versioned,
“UU16” will be moved to the guest-to-host block of the common area when the new
version of UPH performs an in-state license request. Similarly, “UU17” will be moved
when a request using an out-of-state license is performed.
NOTE: The names and function codes below are examples only. These things change
with every release of the system to minimize confusion with earlier releases of the
software.
Chapter Five - UMS Program Control Tables
87
Registry of Motor Vehicles – UMS Programmer’s Manual
Internal Function Codes List
SCREEN
NAME
----------LH
FUNCTION CODE
NAME 1
-------------------LH10
LH20
LH30
FUNCTION CODE
NAME 2
-------------------------
LI
LI07
LI08
LI09
LI10
LN
LI04
LNO
LD08
LNS
LD04
LTH
LI07/LB10
LI08/LB10
SDH
SDH0
SDH1
SDH2
SDH3
SDH4
SDH5
SDH6
SDH7
SDH8
SDH9
UPA
PA01
PA02
PA03
PA04
PA05
PA06
PA07
PA08
UPCR
UU04
UU05
UU12
UU13
UPH
UU08
UU09
UU16
UU17
UPIC
UU06
UU07
UU14
UU15
Chapter Five - UMS Program Control Tables
88
Registry of Motor Vehicles – UMS Programmer’s Manual
UPOI
UU10
UU18
UPTH
UU19
UU20
URI
URSN
URI1
URI2
URI3
URI4
UR04
URI5
URI6
URI7
URI8
UR07
URSR
UR02
UR05
URSV
UR03
UR06
URVN
UR08
UR16
USH
SH03
SH04
SH05
SH06
SH07
SH08
UVH
VH01
VH02
VH03
VH04
Chapter Five - UMS Program Control Tables
89
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Five - UMS Program Control Tables
90
Registry of Motor Vehicles – UMS Programmer’s Manual
6
LXTABLE Processing
Feature Summary -- LXTABLE Processing
The UMS subsystem has incorporated an automatic screen data handler referred to as
“LXTABLE Processing,” which is located in its GUEST software. This processing
mechanism is invoked transparently to the application program(s) by the
Control/Dispatch mechanism based on the XLATE=<lx-tbl-name> parameter in the
System Control Table. The value <lx-tbl-name> is the linkedit name of the assembled
LXTABLE. On input and output operations, it converts data from screen to internal
format and vice versa. On input only, it will perform the value edits and/or specific
content/cross field edits requested. If edit errors occur on input, control never passes to
the application but the screen is rewritten, with error messages, for correction. The inputedit error-message cycle continues until all fields pass the edits. At that point, control is
passed to the designated application program with the screen-data in the Common Area.
LXTABLE processing has two components, the table-driven ‘LX-Program’ (UGZ0006P)
and a macro generated, application specific ‘LX-table’ linked as a load module. This
mechanism’s use is required in all UMS applications to standardize field editing and
screen formatting functions. As the program UGZ0006P serves all applications, it does
reduce programmer effort in these areas speeding application development and reducing
maintenance time. Its basic design is rooted in a product designed and implemented for
the ALAR RA function, but the UMS version is quite different.
The LX-table relates the data fields of the user’s commarea with the defined screen-dsect
for the application. This table is created by the programmer and defines all the involved
data fields. The entries in the table for each field pair may specify certain standard edits,
including cross-field checks and values. In this discussion, the term LXTABLE refers to
the composite effect of the two components.
The LXTABLE mechanism depends in part, on the presumption that each element has
two control fields associated with it. These fields are each 1 byte long and are named
ZFLD and TFLD. The ZFLD byte is used to contain commands relative to the field
passed between the application and the LXTABLE mechanism. The TFLD is seldom
used and is a provision for passing an optional override attribute. The derivation of the
names ZFLD and TFLD is rooted in the ALAR RA implementation, and the mnemonic
implications of these names (if any) is not known.
General data elements may be located anywhere in the UMS common area, but the
structure requires that each data element be immediately preceded by the ZFLD and
Chapter Six - LXTABLE Processing
91
Registry of Motor Vehicles – UMS Programmer’s Manual
TFLD bytes. This is very dissimilar from the ALAR RA implementation which uses 3
lists of fields. The processing supports the use of output-only (as opposed to general)
data elements. These elements are always located in the host interface block and are not
preceded by the ZFLD/TFLD set.
LXTABLE provides automatic field conversion services for the application. This
relieves the application of this coding and insures that they are done in a consistent
manner. Complete instructions for use are given in the Detail Description portion of this
chapter. The following are some of the types of field conversion supported. See the Edit
Type Table on page 107 for a full listing:
1.
Date: on input, dates are analyzed for proper syntactical format (mm/dd/yy,
mm/dd/yyyy, mmddyy, mmddyyyy, yyyy/mm/dd) and converted to standard
halfword binary (WAASDATE, # of days away from 1/1/41) format. The various
components of the date are also checked for legitimacy. On output, the standard
halfword binary dates are converted to mm/dd/yyyy format. The null-date
(x'8000') is properly converted.
2.
Month/Year dates: these dates are converted to and from the RMV standard
internal format for month/year dates, with proper field editing. The most common
use for this type of field is registration expiration dates.
3.
Zipcodes: zipcodes are converted to and from standard RMV internal form.
4.
Case: for input fields, LXTABLE automatically performs lower to upper case
translations. This is particularly important in the UMS guest environment where
it is not possible to require that the terminals be configured for upper-case only.
Further, the same process strips nonstandard display characters which may be
included by some non-IBM 3270 type devices.
5.
Erase-EOF: automatically converted to the null value for the defined field type.
6.
Numeric: on input, fields with a generic type of numeric are edited for numeric
content (or omitted), and treated as though they had been entered with right
justification and left zero fill. On output, they are formatted according to several
possible standardized structures.
7.
Numeric Conversion: fields on the screen with a generic type of numeric clearly
must contain EBCDIC data. LXTABLE allows the programmer to have his
internal data definitions in one of several supported formats. The programmer
may define the internal numeric fields as packed, binary or zoned and LXTABLE
will automatically convert the screen fields to/from these formats.
LXTABLE provides a generalized VALUE editing scheme for screen fields. This means
that the programmer, in the LXTABLE itself, may specify lists of values which are
allowed (or disallowed) for each field. LXTABLE will force the conformation to these
Chapter Six - LXTABLE Processing
92
Registry of Motor Vehicles – UMS Programmer’s Manual
specifications. This facility provides a generic error message for violations, or allows the
option of specifying a specific text for each field. The EXIT facility allows the user to
write specialized edits that may be used on one or more screen fields.
On output, LXTABLE accepts commands (in the ZFLD byte) relative to each field. The
commands and their values ( ) are:
1.
ERROR: ( E ) highlight the field, position the cursor to the field if it is the first
such field on the screen.
2.
TRANSMIT: ( X ) the field is overlaid on the screen with its current content in
the commarea, after proper conversion.
3.
ERROR/TRANSMIT: ( H ) a combination of 1 and 2.
4.
RESET: ( R ) the field attribute is set to its default value from the map definition.
5.
TRANSMIT/CURSOR: ( K ) the field is overlaid on the screen with its current
content in the commarea, after proper conversion. The cursor is positioned to the
field if it is the first such field on the screen.
After processing these commands, LXTABLE clears the ZFLD byte.
The ZFLD byte for unprotected input fields is used to indicate to the application program
if the field in question has been logically changed (value = 'C'). Logically changed does
not mean the MDT is set, but rather means that, after all involved conversions, it has a
different value than the value currently stored in the commarea. In the ZFLD notification
of change, LXTABLE uses a stepdown technique of indicating change in current iteration
('C') and change in previous iteration ('P'). All of these notifications are superseded by
any output command for the field which is issued by the application.
The TFLD serves two functions. On input, if the option PASSMDT=YES is set, the
presence of the MDT for the field is shown by B'00000100' in the TFLD. Absence of the
MDT is shown as X'00'. On output, any value in the TFLD is sent to the screen as the
attribute byte for this iteration.
LXTABLE contains an option (AUTORES) which allows the reset-to-default attribute
option to be the default for all transmit operations.
LXTABLE incorporates a concept known as field classes. The classes are DATA, KEY,
and KEY-SUPPORTIVE. The purpose of this concept is to allow a screen to be partially
edited. In essence, if fields are put in the class of KEY -- AND ARE LOGICALLY
CHANGED -- the editing of DATA fields which follow on the screen is bypassed. This
technique is important for situations where the operator may get sufficiently wound-up in
errors to decide that his only option is to alter a key field and essentially restart a
transaction.
Chapter Six - LXTABLE Processing
93
Registry of Motor Vehicles – UMS Programmer’s Manual
LXTABLE processing is declared for a function in its UMS System Process Control
Table Entry, Guest (PCTEG). The exact parameter is:
XLATE=<lx-tbl-name>
Providing the 8-character LX-table name (<lx-tbl-name>), activates LXTABLE
processing at the appropriate times. As part of the NDR implementation, a technique of
invoking the UMS GUEST LXTABLE processor from an ALAR application was
developed. This technique is not transparent to the application (as in the UMS GUEST
version), but requires the addition of a few statements to the application program.
The LXTABLE exception EXIT processing facility is a mechanism which allows the
programmer to augment the LXTABLE processing on a field by field basis in designated
circumstances such as edit fail, edit pass, or every time. This EXIT facility allows the
execution of user code within the LXTABLE input process. This code may be used to
issue errors not normally recognized by LXTABLE or to bypass errors normally
recognized. These conditions may be recognized with complete access to the commarea,
as well as access to the map data (normally not available with LXTABLE processing).
Note that this option is only to be used in exceptional circumstances. If the editing to be
done will be required in other places in the system, then a standard edit will be produced
to use with the EDIT parameter. This exit facility is further described in the second part
of this chapter.
The field types defined below are supported.
minimum
length
data-type
char
1
num
1
packed
1
binary
1
date
10
type
maximum
length
79
15
15
9
10
GSA
data-type
C
Z
P
FL4 or F
HL2 or H
MAP
C
Z
Z
Z
C
The LXTABLE software processes fields in the order in which they are assembled in the
LXTBL entries in the LX-table module. These entries should be defined left to right, top
to bottom in relation to the screen. If they are not, processing will occur in a proper
manner but an error message posted will refer to the first processed field, not necessarily
the first on the screen with an error.
Fields determined to be changed have their flag-byte value first set to an intermediate
value (which is C'*') until all error-resolution is complete, and are then set to the proper
value of C'C' before the application program is invoked. In addition to being intensified,
the error fields have their MDT forced on when the error screen is shown, to insure that
they are reentered.
Chapter Six - LXTABLE Processing
94
Registry of Motor Vehicles – UMS Programmer’s Manual
The LXTABLE software maintains two levels of field change detection. The basic level
is finding the MDT that is turned on. Once this is detected, the software compares the
value in the field (after it is syntax checked) with the value currently in the GSA area. If
they are equal, the field is treated as though it had not been changed. For these purposes,
a numeric field which has been erase-EOF'd is treated as if a value of 0 (zero) had been
entered. Note that when comparing numeric fields (zoned or packed), if the GSA data
area does not contain a valid sign code, the comparison is treated as not-equal (field
changed).
There is a potential case where a field may be flagged as changed but logically have the
same value as prior to the change. This occurs if (1) a legitimate change is detected on
the field, (2) in the same demap operation an error is detected in another field, and (3)
during the correction of the error the user changes the first field back to its original value.
If the application program indicates a field with error, and does not provide an attribute
byte, the mapping software will supply a default attribute. The value will be intensified,
unprotected, MDT-on. If the field is numeric (in the LXTBL definition) this attribute
will be set as well.
The fields corresponding to mapname, maplength and cursor-position in the guest
common-area should not be changed. If the map/demap software detects a changed value
in maplength, it will assume that the user has prepared the correct map for transmission
and will perform no output gsa-map interactions. This is an override feature available to
the application which must be exercised with EXTREME care as it is possible to create
an unresolvable error-conflict situation after the next receive operation.
UMSLXTBL Quick Look
To implement LXTABLE processing for an application, one must add the name of the
LX-Table to the Guest PCTEG in the form of the parameter
XLATE=<lx-tbl-name>
To create the LX-Table itself the CICS map and its dsect must be created along with the
GSA Common storage definitions the application program will use. With these available
the LX-Table may be assembled. It requires one TYPE=START macro and, for each
screen-field / GSA Common field pair, one TYPE=DETAIL macro. Descriptions of the
parameter values is in the following section, Detail Description. When items are
enclosed in { }, choose one of them.
Chapter Six - LXTABLE Processing
95
Registry of Motor Vehicles – UMS Programmer’s Manual
<name>
UMSLXTBL TYPE=START,MAPNAME=<mapname>,AUTORES=YES/NO,
PASSMDT=YES/NO,
LEVEL0=YES/NO/<null>
UMSLXTBL TYPE=DETAIL,MAPFLD=<mfldname>,
{ GSAFLD=<gfldname>,| HOSTFLD=<hfldname>, }
OPTION1=<null>|LZFILL|RTJUST,
KEYFLD=<null>|0|1|3|4,
VALUE=(<vtype>,<valuelst> | R<vtype>,<valuepairs>),
VALEROR=<error-num>,
EDIT=(<editype><edit fld lst>),
REQUIRE=YES|NO,
EXIT=(<exitparms>)
Detail Description
The LXTABLE Macro
This section discusses the parameters of the LX-Table macros in detail with some
examples. The LXTABLE relates mapfields to storage fields and specifies certain kinds
of automatic edits and value checking that may be required. The data generated in the
table allows the MAP/DEMAP Module to move the data from the mapped-in screen to
common storage or vice versa with the editing requested and certain data-type
conversions (eg. edited date <--> internal half-word format date). The default value for a
parameter will be in BOLD type. APPENDIX L has a sample generation of a small LX
table showing the various parameters and features in use. Part I of the appendix is the
assembly listing to illustrate the macro expansions and code generation. Part II is a hex
dump of the load module from the assembly (and link). These examples are marked to
show where the generated code appears in the load module. Fragments of code are
included as examples with this discussion.
The LX-Table load module will always have the csect <lx-tbl-name> as the first csect. If
the VALUE or EDIT parameters are specified a second csect, always called CSECT2,
will be generated in the load module.
In the various illustrations, <null> means the parameter was omitted (or specified as, for
example, LEVEL0=, or LEVEL0=''). The vertical bar '|' separates the valid parameter
values. The <null> represents the omitted parameter, or value, as mentioned previously.
A bold value is the default parameter value.
Chapter Six - LXTABLE Processing
96
Registry of Motor Vehicles – UMS Programmer’s Manual
The UMSLXTBL TYPE=START
The first invocation, or macro in the table, must be:
<name> UMSLXTBL TYPE=START,MAPNAME=<mapname>,AUTORES=YES/NO,
PASSMDT=YES/NO,
LEVEL0=YES/NO/<null>
<name> is the name of the LX-Table to be created, 8characters long
TYPE=START generates the LX-Table header.
<mapname> is the name of the related map,
7-characters long
The above are required on TYPE=START and are not allowed for
TYPE=DETAIL.
LEVEL0=YES | NO allows or suppresses an mnote showing the type of edit that
was requested for the individual fields.
PASSMDT=YES | NO pass or not pass the modified data tag through to the
application program
AUTORES=YES | NO reset or not reset screen attributes to the map default
Chapter Six - LXTABLE Processing
97
Registry of Motor Vehicles – UMS Programmer’s Manual
Sample expansion, TYPE=START
The field generations for TYPE=START are as follows:
1227 *
000000
000008
00000F
000017
000018
00001D
000021
000022
000025
E4C7D3F0F2F6F0E3
E4C7D3F0F2F6F0
F0F661F1F861F9F1
40
F2F34BF5F2
00000000
00
000000
FFFF
1229 UGL0260T UMSLXTBL TYPE=START,
MAPNAME=UGL0260,
LEVEL0=NO
1230+UGL0260T START 0
1231+
PUSH PRINT
1232+
PRINT OFF
1249+
POP
PRINT
1250+
USING MAPINP,R4
1251+
USING
1252+
DC
CL8'UGL0260T'
1253+
DC
CL7'UGL0260'
1254+
DC
CL8'06/18/91'
1255+
DC
CL1' '
1256+
DC
CL5'23.52'
1257+
DC
XL4'0'
1258+
DC
BL1'00000000' FLAGS
1259+
DC
XL3'0'
RESERVED
1260+
DC
XL2'FFFF' TEMP TRLR
Note: this code generation is streamlined for ease of viewing with proper code output.
Line 1252 is the name of this LX-Table. Line 1253 is the related CICS map(set) name.
Note that the date and time of assembly are assembled into the header for documentation
purposes (lines 1254 and 1256). The blank in line 1255 is for date-time readability. In
line 1258, the field of FLAGS, the bits are used as follows (left to right):
1.......
.1......
..000000
reset MDTs
pass MDTs through
unused
(AUTORES=YES)
(PASSMDT=YES)
The fields in lines 1257 and 1259 are unused. In line 1260 the XL2'FFFF' in this and the
expansions of UMSLXTBL TYPE=DETAIL, exist only if ‘this’ invocation of the macro
is the last in the whole table. If it is not the ‘last,’ the expansion of the succeeding macro
overlays it. If it is the last, the MAP/DEMAP Module knows it just saw the last set of
fields to process.
Chapter Six - LXTABLE Processing
98
Registry of Motor Vehicles – UMS Programmer’s Manual
The UMSLXTBL TYPE=DETAIL
The fields and their edits are described below. The field moves and edits proceed in the
order in which the field pairs are assembled into the LX-Table. You therefore control the
processing order of the screen fields. When items are enclosed in { }, choose one of
them.
UMSLXTBL TYPE=DETAIL,MAPFLD=<mfldname>,
{ GSAFLD=<gfldname>,| HOSTFLD=<hfldname>, }
OPTION1=<null>|LZFILL|RTJUST,
KEYFLD=<null>|0|1|3|4,
The 5 following parms are optional and related to edits for the field. They
are discussed in groups after the parameters above.
VALUE=<null> | (<vtype>,<value> |
R<vtype>,<valuepair>)
VALEROR=<null> | <error-num>,
EDIT=<null> | (<editype>,<edit fld list>),
REQUIRE=NO | YES,
EXIT=<null> | (<excsect>,<exreas>,<exinvn>)
MAPFLD, GASFLD, HOSTFLD
The TYPE=DETAIL describes a CICS map field-name GSA Common data field-name
pair between which data will be moved with needed data-conversion and optional edits.
The CICS map field-name is <mfldname> and the MAPFLD parameter is required. The
GSA Common field may be in either ‘program storage’ or in HOST related storage. If it
is in ‘program storage’ use the GSAFLD parameter with <gfldname> as the field name.
For HOST related storage, use the HOSTFLD parm with <hfldname>. If HOSTFLD =
<hfldname> is specified, the field-pair is restricted for storage-to-screen use only
(&OUTONL = '1'). The ‘program’ field name is placed into the internal macro variable,
&INTFLD. Data-field types are checked.
Allowed for MAPFLD are T'= C | Z.
Allowed for 'program' fields are T'= C | Z | F | H | P | X | G.
If the type is 'G', and L'= 2, the type is set to 'H', or if L"= 4, then type is set to 'F'.
Anything else is an error. The valid type-pairs for <mapfld><intfld> are 'ZZ', 'ZP', 'CC',
'ZF', 'CH', and 'CX'. The general edit rules and internal macro field settings are as
follows:
Chapter Six - LXTABLE Processing
99
Registry of Motor Vehicles – UMS Programmer’s Manual
'ZZ'
Both zoned numeric - max 15 digits long, field
lengths to be equal
&NUMFLD
&VALLOW
&IFVALOK
&WRKLEN
'ZP'
'CX'
'004'
L'<mapfld>
'PL&WRKLEN'
'1'
&RTN
'1'
&VALHI
'C'
&VALHDR
L'<mapfld>
'008'
L'<mapfld>
'CL&WRKLEN'
Zoned numeric screen field, length LE 9, and
L'&INTFLD to be EQ 4
&NUMFLD
&VALLOW
&IFVALOK
&WRKLEN
'CH'
'1'
&RTN
'1'
&VALHI
'#'
&VALHDR
(L'<mapfld>/2)+1
Both character fields with fields to be of equal
length and LE 79 characters long.
&NUMFLD
&VALLOW
&IFVALOK
&WRKLEN
'ZF'
'000'
L'<mapfld>
'PL&WRKLEN'
Zoned numeric screen, packed in 'program' L'&INTFLD
to be LE 8, L'&INTFLD+L'INTFLD-1 to be GE L'&MAPFLD
&NUMFLD
&VALLOW
&IFVALOK
&WRKLEN
'CC'
'1'
&RTN
'1'
&VALHI
'#'
&VALHDR
(L'<mapfld>/2)+1
'1'
'1'
'#'
'4'
&RTN
&VALHI
&VALHDR
'012'
L'<mapfld>
'FL4'
Screen date to internal fmt (no value editing
allowed), L'&MAPFLD to be 7 or 10, L'INTFLD to be 2
&NUMFLD
<null>
&RTN
&VALLOW
&IFVALOK
&WRKLEN
'4'
'X'
'2'
&VALHI
&VALHDR
&DATEFLG
'016' (L'10),
'020' (L'7)
'4'
'AL2(X'''
'1'
Screen zip-code to internal fmt, L'&MAPFLD to be 10,
L'INTFLD to be 6
Chapter Six - LXTABLE Processing
100
Registry of Motor Vehicles – UMS Programmer’s Manual
&ZIPFLAG
'1'
&RTN
'024'
OPTION 1
RTJUST and LZFILL(for numeric only) are edited. These actions are applied upon
output only. They have no effect at screen-input processing time. Type flags are checked
and, if &WARN NE 'N', macro emits MNOTE,0 for edit specified, if any.
If &VALUE NE <null>
If &EDIT NE <null>
&VALFLAG '1'
&EDTFLAG '1'
&CHKMAP = 'M$&MAPFLD'
&XYZ is set to a concatenation of all flags
&OP1FLAG&ZIPFLAG&EDTFLAG&VALFLAG&OUTONL&EXPIFLG&DATEFLG
&NUMFLG
Code generation now occurs for the basic part of the macro and, if there are no value or
edit clauses, the macro expansion is completed. A general layout follows with some
actual examples in the following section.
Code generated is: in 'main' csect
1
2
3
4
5
6
7
8
&CHKGSA DC AL1(<dns>),AL1(&RTN)
&CHKMAP DC BL1'&XYZ'
DC BL1'&KEYF&OP1FLAH'
DC AL2(&INTFLD-&BASE-2)
DC AL2(&MAPFLD-MAPINP-3)
DC AL1(L'&INTFLD-1),AL1(l'&MAPFLD-1)
DC AL4(<v-array>) --> value array, if used
DC AL4(<e-array>) --> edit array, if used
DC XL2'FFFF'
1.
First is one byte of displacement (<dns>) to the next table section, either
another field or EDIT/VALUE fields for this one. Points to the X"FFFF'
Chapter Six - LXTABLE Processing
101
Registry of Motor Vehicles – UMS Programmer’s Manual
only if this the end of the table. The X'FFFF' is overlaid by the continuing
or the next macro expansion.
Second is one byte of field-pair type.
2.
One byte of flags as follows:
1.......
.1......
..1.....
...1....
....1...
.....1..
......1.
.......1
3.
Left Zero Fill asked
Zip Code fields
Edit control block present
Value control block present
Out only field-pair
Expiration format date
Internal-External date fields
A numeric value pair
One byte of flags as follows:
0000....
....111.
.......1
Unused
KEYFLD value in binary
Right Justify asked
4.
Two bytes for program-field displacement from either UGCOMMON or
UHCITEXT. Then two bytes of map-field displacement from MAPINP.
5.
One byte = length of 'program'-field -1.
One byte = length of map-field -1.
6.
A pointer to the value array (if specified in a VALUE parameter) in
CSECT2 of the load module.
7.
A pointer to the edit array (if specified in an EDIT parameter) in CSECT2
of the load module.
8.
Two bytes, X'FFFF', as an end of table flag. If there is another macro after
this one, its expansion overlays the X'FFFF'.
KEYFLD
The form of the parameter is:
Chapter Six - LXTABLE Processing
102
Registry of Motor Vehicles – UMS Programmer’s Manual
KEYFLD=<null> | 0 | 1 | 3 | 4
<null> = 0
1
3
4
=
=
=
=
not a key field
a key field
sometimes a key field
force edit
The ability to designate key-fields applies a further control to the automatic edits. If a
field designated as “key” is found to be changed (and passes any edits), all other edits for
non-key fields will be skipped. The assumption is that where key data is changed, the
operator wishes to switch to a different “base entity” such as a different person or vehicle.
The value of “4” will direct that the edit be carried out even in the face of a key-field
change. The value of “3” gives the application the ability to dynamically designate the
field as key or non-key at run-time. If the first byte of the USER portion of the
Commarea is X'04', the “3-fields” will be edited as key. If the first byte is some other
value, they are treated as ordinary fields.
Chapter Six - LXTABLE Processing
103
Registry of Motor Vehicles – UMS Programmer’s Manual
Value Checking
VALUE, VALEROR
The value checking mechanism enables one to allow or disallow a single value, a series
of individual values, or a range of values through the VALUE= parameter in the
UMSLXTBL macro. The 9-digit VALEROR= parameter value directs the issuance of a
specific error message if the value edit fails. If the value edit fails and no VALEROR
parameter is given, a generic error message issues. All the code generated for value
editing is assembled into the csect called CSECT2. The LX-Table load module will
always have the csect <name> and optionally, CSECT2 if value checking and/or editing
is specified. MNOTEs are issued for any edit failure in the macro. The parameter is
coded as follows:
The presence of a 9 numeric digit <errornum> in the VALEROR= clause, causes
&ECODE to be set to '1' (else it is '0').
If &IFVALOK is 'X', &SIGN is set to '1', else '0'.
VALUE=<null> |
(<vtype>,<valuelst> | R<vtype>,<value-pairs>)
Where: <vtype> = ALLOW | DISALLOW
<valuelst>
= <value>,<value> ... as required
<value-pairs> = <value2>,<value2> ... as required
<value2>
= <value>,<value>
a pair for a
range
<value> = any value the field may assume
The VALUE clause may not be used on output-only fields (&HOSTFLD that causes
&OUTONL to be '1') or on fields where &IFVALOK is left as 'N'. The characters in the
value string are edited for correctness as numerics or a hex string as the case may be. An
MNOTE issues in case of error. Two internal macro values are set based on <vtype>.
The VALUE clause may be specified with the EDIT clause in the same TYPE=DETAIL
macro. Note that in such a case, the VALUE clause edits are applied before those of the
EDIT clause.
WARNING: An input value of 0 (zero) or blanks will be passed through to the
application regardless of the value clause's sub-parameters.
Chapter Six - LXTABLE Processing
104
Registry of Motor Vehicles – UMS Programmer’s Manual
<vtype> = ALLOW
DISALLOW
R<vtype> = ALLOW
DISALLOW
Code generated is:
DC
DC
DC
DC
DC
DC
&SYSECT
<vlabel>
&VALTYPE
Value
'0'
'1'
'0'
'1'
'0'
'0'
'1'
'1
single
single
range
range
In 'main' csect
AL4(<v-array>)
Code generated is:
&COMPTYP
--> to value list in csect2
In CSECT2
FL4'&VALEROR' error msg number (if any)
BL1'&ECODE&SIGN&COMPTYP&VALTYP' flags
AL1(<actual field length>)
AL2(<number of list elements>)
<elements>
CSECT
return to 'main' csect
<elements> = sets of the data type, the true field
length and a value that represents the value(s)
in the list.
For example
CL3'C&C'
CL5'RMV'
ZL4'789'
If &VALEROR is <null>, &ECODE is '0' and the FL4 field is not generated. If
&VALEROR is given and a value edit fails, that error message will be displayed on the
screen with out application program intervention. If VALEROR is omitted, a generic
message is sent.
Chapter Six - LXTABLE Processing
105
Registry of Motor Vehicles – UMS Programmer’s Manual
Edit Checking
EDIT, REQUIRE
The EDIT clause routines perform services such as check-digit validation, ensure
numerics, town-code conversions, date checks and conversions, and non-database crossfield checking. One may designate the field as required, REQUIRE=YES, to produce an
error message if the field is not supplied. Code generation builds control blocks in
CSECT2 of the LXTABLE. The EDIT and VALUE clauses may be specified in the
same TYPE=DETAIL macro. In such a case, the VALUE clause edits are applied those
of the EDIT clause.
The form of the parameters are:
REQUIRE=NO | YES
if Yes and no data, error
if YES, &REQ = 1 ( else = 0 )
EDIT=(<editype><edit fld lst>)
<editype> a literal from the Edit Type Table on page
5-18 that tells UGZ0006P(map/demap pgm) what to
do
<edit fld lst> = <fldn> | <fldn>,<fldn+1> ...
<fldn> etc is the name(s) of the field(s) to be
edited (the table shows the requirements)
Code generated: in csect CSECT2
<E-label> DC
DC
DC
DC
<e-label> DC
AL1(<e-label - E-label) length of this array
AL1(&REQ&MODE)
&MODE unused, = 0
AL2(&TYPE)
edit to do, 0-19
AL4(<lxptr>)
--> block in main table
0AL1
label for length calc
Chapter Six - LXTABLE Processing
106
Registry of Motor Vehicles – UMS Programmer’s Manual
Edit Type Table
Note: The number of fields required is absolute, too few or too many errors out the macro
with an MNOTE. If the # of fields required is 1, the edit applies to the current macro
being expanded. If more than 1 field is required, they must be in the current macro or
already expanded. If any of the fields come later, the macro errors out. The fields must
have the type and length specified or the macro fails.
Edit
Type Literal Description
# Fields Required
0
1
2
3
4
LICNO
VIN
TCODE
ICODE
REGNO
MA lic #, 9-byte
VIN, 17 byte, chkdgt
Town Code
Insurance Code
Registration
1
1
1
1
3
5
6
MADDR
RADDR
Optional Address
Required Address
5
5
7
MLICN
License Number, 9-byte
2
8
9
TITLE#
PDATE
Title Number
Policy Date Ranges
1
2
10
PNAME
Person Name
3
11
ILOCN
Insurance Co. Location
2
12
MLINC2
License #, 25-byte
2
13
14
15
16
SOCNO
MONEY
LICNO/S
MLICN2
/NOMA
AGE1511
AGE1600
MLICN2/XX
Social Security #
Money edit
Lic # w/'S' allowed
License, 25-byte w/
no ST default
Age Edit, dob/permit
Age Edit, dob/license
Lic # 25 byte
w/ XXnolicense
1
1
1
2
17
18
19
1
1
2
CL9 license number
CL17 the VIN
PL2 internal town code
PL2 internal Co. id.
CL3 plate type
CL1 plate color
CL7 registration #
(see type 6)
CL20 address line 1
CL20 address line 2
CL15 city/town
CL2 state
XL6 zip code
CL9 license number
CL2 state
CL8 the title number
H effective date
H expiration date
CL16 last name
CL12 first name
CL8 middle name
PL2 Co. code, internal
PL2 town code, internal
CL25 license #(non MA)
CL2 state
CL9 SSAN (CL / ZL)
CL3 to CL21, money field
CL9 license #
CL25 license #
CL2 state
H dob, internal fmt
H dob, internal fmt
CL25 license #
CL2 state
Chapter Six - LXTABLE Processing
107
Registry of Motor Vehicles – UMS Programmer’s Manual
User Exit - LXTABLE
An LXTABLE exit is user-code included as part of the assembly and link of an
LXTABLE. This feature provides processing of editing criteria, which are NOT an
integral LXTABLE function, during the de-map phase of LXTABLE processing (before
invocation of the application program). This supports the simplification objective of
keeping screen edits outside the application program.
These exits are not designed to (and are not to be used to) replace (or augment) standard
procedures which occur in many places. They are intended to be used in “unique”
circumstances. That means that if some type of common field not yet accounted for by
LXTABLE evolves, it is not to be processed with an exit BUT, through an addition to the
standard LXTABLE processing.
Examples of the exit code are provided as a code-fragment on page 111 and as a part of
an assembled table that begins on page 117.
EXIT Specification:
The specification of these exits is a part of the UMSLXTBL macro. The involved
argument is:
EXIT=(<exname>,<exr>,<exc>).
<exname> is the 1-8 character csect name assigned to
the exit routine
<exr> = <null> | <exreason>
<exreason> is a 2 hex-digit (or 8 binary-digit)
expression of why/when the exit is to be
invoked, to wit:
X'10' always (unless the data fails
conversion, eg. non-numeric in numeric
field), before value and editing
processing.
X'08' after failure of an edit operation
X'04' after passing an edit operation
X'02' after failing a value-check operation
X'01' after passing a value-check operation
<exc> = <null> | <excode>
<excode> is an unsigned halfword in the decimal
Chapter Six - LXTABLE Processing
108
Registry of Motor Vehicles – UMS Programmer’s Manual
number range of 1 - 65535, which uniquely
identifies the exit invocation.
The value of <exreason> is not checked at generation time to determine if the user has
specified values other than the above. If no value is specified, an automatic value of
ALWAYS (X'FF') is generated. Specification of a value of zero is detected as an error.
If a 2 digit value is specified, the digits must be HEX (0-9, A-F), if a 8 digit value is
specified, the digits must be BINARY (0-1). No other possibilities are allowed.
The <excode> value (ranging between 1 and 65535 decimal) is intended to allow the
user's exit to be invoked relative to more than 1 map-field and to be able to differentiate
which invocation is current. Each potential value may occur only once in any single
LXTABLE. The field may be omitted, in which case a default value is assigned. The
first default value is 65535, the second 65534, etc.
If it is desired to enter an exit for multiple reasons, the desired reasons may be OR'ed
together to form a composite reason. When the routine is entered, it is informed of the
specific reason for this entry (as opposed to any composite), as well as a history of its
entry for this field within this LXTABLE invocation (EXITWHYS).
Examples:
* EXAMPLE: NUMERIC TO PACKED, OUTPUT MUST BE LONG-ENOUGH
UMSLXTBL MAPFLD=MNUM2,GSAFLD=GNUMP,OPTION1=LZFILL,
EXIT=USER01
*
*
* EXAMPLE: DATE, INPUT MUST BE CL10, OUTPUT MUST BE H OR
HL2
UMSLXTBL MAPFLD=MDATE,GSAFLD=GDATE,EDIT=AGE1600,
VALUE=(ALLOW,8000,0000,FFFF,7FFF),EXIT=(USER02,01
,99)
Chapter Six - LXTABLE Processing
109
Registry of Motor Vehicles – UMS Programmer’s Manual
Exit Environment:
The exit is presented with the GUEST common area and an exit argument block.
It can make any evaluation it desires and indicate three possible actions:
a. force a specific error condition
b. force no-error condition
c. continue with normal processing
In all cases, normal processing would be (1) no-error, or (2) some error detected
by normal LXTABLE processing.
On entry:
(R12) holds the address of the exit
(R9) holds the address of the GUEST common
(R8) holds the address of the exit argument block.
The exit argument block is as follows:
EXITDATA
EXITCODE
EXITWHYS
EXITRETN
EXITWHYX
EXRVALOK
EXRVALNG
EXREDTOK
EXREDTNG
EXRALWAY
EXITUSER
EXITACTN
EXANOACT
EXANOERR
EXAWIERR
EXITEROR
DSECT
DS
DS
DS
DS
EQU
EQU
EQU
EQU
EQU
DS
DS
EQU
EQU
EQU
DS
AL2
XL1
AL4
XL1
B'00000001'
B'00000010'
B'00000100'
B'00001000'
B'00010000'
0XL5
XL1
B'00000000'
B'00000001'
B'00000010'
XL4
EXITCODE
EXITWHYS
EXITRETN
EXITWHYX
UNIQUE IDENTIFIER CODE
SUMMATION OF ENTRY REASONS
RETURN ADDRESS
REASON FOR THIS ENTRY
VALUE IS OK
VALUE IS NOT ACCEPTABLE
EDIT IS ACCEPTABLE
EDIT IS NOT ACCEPTABLE
ALWAYS ENTER UNLESS FMT ERR
USER PARMS
USER ACTION REQUEST
CONTINUE, NO ACTION
CONTINUE, NO ERROR
CONTINUE, POST ERROR
USER ERROR CODE
the value of <excode>
a running OR of the reasons this exit
has been invoked for this field in this
LXTABLE invocation
return address
the reason for this invocation
<exreason>
Chapter Six - LXTABLE Processing
110
Registry of Motor Vehicles – UMS Programmer’s Manual
EXITACTN
EXITEROR
user specified action
0 continue with normal processingdefault
1 continue with no-error
2 continue with error
error-code to post if EXITACTN=2.
defaults to a generic error-code.
User Exit Example - Code Fragment
Example #1
* USER EXITS:
DROP
UGLTEST1 CSECT
USING UGCOMMON,R9
USING EXITDATA,R8
USING USER01,R12
COMMON AREA
EXIT DATA
ROUTINE BASE
* THIS EXAMPLE WILL FORCE NO-ERROR IF THERE IS AN EXISTING ERROR
* AND WE HAVE BEEN ENTERED FOR THE REASON OF AN ERROR. IN ANY
* OTHER CASE, NORMAL FLOW WILL BE OBSERVED
USER01
U19999
DS
OC
BZ
TM
BZ
MVI
ICM
BR
LTORG
0H
UGGERRCD,UGGERRCD
PREVIOUS ERROR?
U19999
NO
EXITWHYX,EXRVALNG+EXREDTNG
REASON=ERROR?
U19999
NO
EXITACTN,EXANOERR
FORCE ERROR
R14,B'1111',EXITRETN
GET RETURN ADDRESS
R14
EXIT
Example #2
UGLTEST2
DROP
CSECT
USING UGCOMMON,R9
USING EXITDATA,R8
USING USER02,R12
COMMON AREA
EXIT DATA
ROUTINE BASE
* THIS EXAMPLE WILL FORCE AN ERROR IF GDATE=X'7FFF' AND GCHAR=
* ALL '$'. IN ANY OTHER CASE, NORMAL FLOW WILL BE OBSERVED
Chapter Six - LXTABLE Processing
111
Registry of Motor Vehicles – UMS Programmer’s Manual
USER02
U29999
DS
CLC
BNE
CLI
BNE
CLC
BNE
MVC
MVI
ICM
BR
LTORG
DROP
END
0H
GDATE,=X'7FFF'
7FFF?
U29999
NO
GCHAR,C'$'
1ST BYTE OF GCHAR=$?
U29999
NO
GCHAR+1(L'GCHAR-1),GCHAR
REST=$?
U29999
NO
EXITEROR,=F'123456789'
SET ERROR-CODE
EXITACTN,EXAWIERR
FORCE ERROR
R14,B'1111',EXITRETN
GET RETURN ADDRESS
R14
EXIT
Chapter Six - LXTABLE Processing
112
Registry of Motor Vehicles – UMS Programmer’s Manual
Internal Field Values - UMSLXMAC
Parameter-Related (directly)
Parameter
Macro Internal
Name
Value Field name Value
__________________________________________________________
PASSMDT
YES
NO
&MDT
YES
NO
&RESET
OPTION1
LZFILL
RTJUST
&OP1FLAG
&OP1FLAH
'1'
'1'
LEVEL0
YES
NO
<null>
&WARN
'Y'
'N'
'Y'
0
1
3
4
&KEYF
AUTORES
KEYFLD
'1'
'0'
Default
'1'
'0'
Default
Default
'000'
'001'
'011'
'100'
Default
The next three fields define the screen-field - main storage-field pair
represented by this invocation of the macro. The main storage field is
either GSAFLD or HOSTFLD, not both.
MAPFLD
<mapfldnm>
&MAPFLD
GSAFLD
<fname>|<null>
&INTFLD
&BASE
&OUTONL
&CHKGSA
<fname>
'UGCOMMON'
'0'
'G$&GSAFLD'
HOSTFLD
<null>|<fname>
&INTFLD
&BASE
&OUTONL
&CHKGSA
<fname>
'UHCITEXT'
'1'
<null>
VALEROR
<err msg #>|<null>
&VALEROR
<err msg #>|<null>
Chapter Six - LXTABLE Processing
<mapfldnm>
113
Registry of Motor Vehicles – UMS Programmer’s Manual
Sample Map Source Fragment
Note the use of the UMSHEADR macro to form the standard heading on the map
(screen). See the assembled sample to view the generation of FLD0001 through
FLD0004 and the (standard) header literals. See the sample map dsect (following) for the
commarea definition. You may relate the use of the field names in the LX-Table macros
for the generation of the ‘translate table.’
UGL0260
FLD0005
FLD0006
FLD0007
FLD0010
UMSHEADR LTH,'LICENSE TRANSACTION HISTORY'
DFHMDF POS=(004,002),LENGTH=0001,INITIAL=' '
DFHMDF POS=(005,001),LENGTH=0010,
INITIAL='LICENSE #:'
DFHMDF POS=(005,012),LENGTH=0025,
JUSTIFY=(LEFT,BLANK),
ATTRB=(UNPROT,IC)
DFHMDF POS=(005,038),LENGTH=0006,
INITIAL='STATE:'
DFHMDF POS=(005,045),LENGTH=0002,
JUSTIFY=(LEFT,BLANK),
ATTRB=(UNPROT)
DFHMDF POS=(005,048),LENGTH=0004,
INITIAL='SS#:'
DFHMDF POS=(005,053),LENGTH=0009,INITIAL=' ',
ATTRB=UNPROT
DFHMDF POS=(005,063),LENGTH=0001
DFHMDF POS=(006,004),LENGTH=0007,
INITIAL='NAME L:'
DFHMDF POS=(006,012),LENGTH=0016,
JUSTIFY=(LEFT,BLANK),
ATTRB=(UNPROT)
Chapter Six - LXTABLE Processing
X
X
X
X
X
X
X
X
X
X
X
114
Registry of Motor Vehicles – UMS Programmer’s Manual
Sample Assembler Map Dsect
0006F8
0006F9
0006FA
1111
COPY UGL0260C
1112
ORG
UGCUSERA
1113 * START OF GSA STORAGE
1114 LHLIC#
GFLD CL25
LH-LIC NUMB
1115+LHLIC#_Z DS
CL1
ZFIELD
1116+LHLIC#_T DS
CL1
TFIELD
1117+LHLIC#
DS
CL25
DATA FIELD
000713
000714
000715
1118 LHSTATE GFLD CL2
1119+LHSTATE_Z DS
CL1
1120+LHSTATE_T DS
CL1
1121+LHSTATE DS
CL2
STATE
ZFIELD
TFIELD
DATA FIELD
1122 LHSSN
GFLD CL9
1123+LHSSN_Z DS
CL1
1124+LHSSN_T DS
CL1
1125+LHSSN
DS
CL9
1126 LHLNAME GFLD CL16
1127+LHLNAME_Z DS
CL1
1128+LHLNAME_T DS
CL1
1129+LHLNAME DS
CL16
1130 LHFNAME GFLD CL12
1131+LHFNAME_Z DS
CL1
1132+LHFNAME_T DS
CL1
SSN
ZFIELD
TFIELD
DATA FIEL
LAST-NAME
ZFIELD
TFIELD
DATA FIELD
FIRST-NAME
ZFIELD
TFIELD
000FEA
000717
000718
000719
000722
000723
000724
000734
000735
006F8
Data ommitted for brevity.
000B7B
000B7C
1209 LHLINE44 GFLD CL79
1210+LHLINE44_Z DS CL1
1211+LHLINE44_T DS CL1
DETAIL LINE
ZFIELD
TFIELD
Chapter Six - LXTABLE Processing
115
Registry of Motor Vehicles – UMS Programmer’s Manual
000B7D
000BCC
000BCD
000BCE
000C1D
000C20
000C24
000C26
000C28
000C2A
000C2B
000D2B
000D2C
006FA
00FEA
1212+LHLINE44 DS
CL79
DATA FIELD
1213 LHLINE45 GFLD CL79
DETAIL LINE
1214+LHLINE45_Z DS CL1
ZFIELD
1215+LHLINE45_T DS CL1
TFIELD
1216+LHLINE45 DS
CL79
DATA FIELD
1217 PHASE
DS
XL1
PHASE COU
1218 PERSSURR DS
F
CURRENT P
1219 NUMOBREF DS
H
TOTAL BRE
1220 BREF1
DS
H
NUMBER OF
1221 BREFX
DS
H
NUMBER OF
1222 PAGEC
DS
XL1
CURRENT P
1223 PAGELIST DS
256XL1 FIRST REC
1224 NOTFOUND DS
XL1
FLAG, NOT
1225 LHGSA
EQU LHLIC#,*-LHLIC#,C'X'GSA
1226
ORG
Chapter Six - LXTABLE Processing
116
Registry of Motor Vehicles – UMS Programmer’s Manual
LXTABLE Assembled Example
EXTERNAL SYMBOL DICTIONARY
SYMBOL
TYPE ID ADDR LENGTH
LXTABTST SD 0001 000000 000117
CSECT2
SD 0002 000118 00006C
CSECT3
SD 0003 000188 00000D
UGLTEST1 SD 0004 000198 000056
LOC
LD ID FLAGS
00
00
00
00
LXTABTST - UMS SAMPLE LXTBL DEFINITION
OBJECT CODE
ADDR1 ADDR2 STMT SOURCE STATEMENT
000000
000000
00000C
00000F
000019
00001C
000021
000024
000028
00002B
0005D
00005D
000060
000071
ASM H V 02 15.47 07/09/91
2 * C&C ASSOCIATES 1989
3
COPY ECELXMAC
4
PUSH PRINT
5
PRINT OFF
996
POP
PRINT
998
UMSHEADR TYPE=DSECT
999+MAPINP
DSECT
1000+* HEADER OF INPUT-MAP/OUTPUT MAP AREA
1001+
DS
CL12
HEADER
1002+
DS
CL3
ADDRESS/ATTRIBUTES
1003+MIDATE
DS
CL10
DATE TEXT
1004+
DS
CL3
ADDRESS/ATTRIBUTES
1005+MITIME
DS
CL5
TIME TEXT
1006+
DS
CL3
ADDRESS/ATTRIBUTES
1007+MIFUNC
DS
CL4
FUNC TEXT
1008+
DS
CL3
ADDRESS/ATTRIBUTES
1009+MITEXT
DS
CL50
MESG TEXT
1010+MI$SLEN EQU
*-MAPINP BASE LENGTH
1011
DS
CL3
BMS DATA
1012 MCHAR
DS
CL17
CHARACTER
1013
DS
CL3
BMS DATA
Chapter Six - LXTABLE Processing
FOR DATE
FOR TIME
FOR FUNC
FOR TEXT
FIELD
117
00100000
00110000
00010000
00020000
09700000
00140000
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
01-UMSHE
00150000
00160000
00170000
Registry of Motor Vehicles – UMS Programmer’s Manual
000074
00007E
000081
000091
000094
0000A0
0000A3
0000AB
0000AE
0000B3
0000B6
0000BD
0000C0
0000C4
0000C7
0000D1
0000D4
0000DB
0000DE
0000E8
0000EB
0000F5
0000F8
0000FB
0000FE
0000FF
000102
000109
00010C
000116
000119
000121
000124
00013D
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
MCHAR2
MLAST
MFIRST
MMIDDLE
MNUM1
MNUM2
MNUM3
MDATE
MDATE2
MDATEA
MDATEB
MPREF
MCOLOR
MREGNO
MZIPC
MTITLE#
MLICN25
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
CL10
CL3
CL16
CL3
CL12
CL3
CL8
CL3
ZL5
CL3
ZL7
CL3
ZL4
CL3
CL10
CL3
CL07
CL3
CL10
CL3
CL10
CL3
CL03
CL3
CL01
CL3
CL07
CL3
CL10
CL3
CL8
CL3
CL25
CL3
Chapter Six - LXTABLE Processing
CHARACTER FIELD
BMS DATA
CHARACTER FIELD
BMS DATA
CHARACTER FIELD
BMS DATA
CHARACTER FIELD
BMS DATA
NUMERIC FIELD
BMS DATA
NUMERIC FIELD
BMS DATA
NUMERIC FIELD
BMS DATA
DATE FIELD
BMS DATA
DATE FIELD
BMS DATA
DATE FIELD
BMS DATA
DATE FIELD
BMS DATA
PREFIX
BMS DATA
COLOR
BMS DATA
REGNO
BMS DATA
ZIPCODE
BMS DATA
TITLE#
BMS DATA
LICNO
BMS DATA
118
00180000
00190000
00200000
00210000
00220000
00230000
00240000
00250000
00260000
00270000
00280000
00290000
00300000
00310000
00320000
00330000
00340000
00350000
00360000
00370000
00380000
00390000
00400000
00410000
00420000
00430000
00440000
00450000
00460000
0470000
00480000
00490000
00500000
00510000
Registry of Motor Vehicles – UMS Programmer’s Manual
000140
000000
000000
000040
00000
1048 MSTATE25 DS
CL2
1050
UGZCOMMA
1052
1053
1054
1055
1056
1057
000000
000008
00000A
00000C
000010
000011
0006F8
00FEA 1274 UGCOMTLN EQU
1058
1059
1060
1061
1062
1063
00001 1064
00002 1065
1066
1271
006F8 1272
1273
*-UGCOMMON
1275
1276
000FEA
0006F8
0006FA
006F8
1277
1278
1279
1280
1281
COPY
STATE
00520000
00540000
* UNINSURED MOTORIST. COMMON-AREA, GUEST SIDE.
UGCOMMON DSECT
UGCPROTO DS
XL64
SYSTEM PROTOCALL DATA
ORG
UGCPROTO
* WITH TWO EXCEPTIONS, THE PROTOCALL AREA IS
* RESERVED FOR THE CONTROL
* SOFTWARE. APPLICATIONS MAY USE THE
* DUBLE-WORD TEMP AND SHOULD NOTE
* THE QUALIFICATION ABOUT PREVIOUS MAPNAME
UGCDTEMP DS
D GENERAL PURPOSE DOUBLE-WORD TEMP
UGCCLENG DS
H
LENGTH FOR USE WITH XCTL.
UGCRDLEN DS
H
INQUIRY/REPLY DETAIL LENGTH
UGCCURFN DS
CL4
CURRENT FUNCTION-NAME
UGCALLON DS
XL1
FLAG BYTE ALL BITS INIT ON
UGCMAPFI EQU
B'00000001' MAP/DEMAP OPER. DEMAP
UGCMAPFO EQU
B'00000010' MAP/DEMAP OPER MAP
DS
CL1
*
UGCUSERA EQU
*
THE USER-PROGRAM AREA
DS
2290XL1
PUSH TO PAGE
TOTAL LENGTH
02060000
* THE LENGTH OF THIS AREA IS TAKEN FROM
* THE PROCESS-CONTROL TABLE
* BUT WILL NOT BE LESS THAN THE VALUE OF
* THE ABOVE EQUATE AT THE LAST
* ASSEMBLY OF UGZ0015P
ORG
UGCUSERA
* START OF GSA STORAGE
DS
CL1,CL1
ZFLD, TFLD
GTITLE# DS
CL8
TITLE#
Chapter Six - LXTABLE Processing
119
00020000
00030000
00040000
00050000
00060000
00070000
00080000
00090000
00100000
00110000
00120000
00130000
00140000
00150000
00160000
02030000
02040000
02050000
02070000
02080000
02090000
00550000
00560000
00570000
00580000
Registry of Motor Vehicles – UMS Programmer’s Manual
000702
000704
000706
000708
00070A
00070C
1282
1283 GDATE
1284
1285 GDATE2
1286
1287 GDATEA
DS
DS
DS
DS
DS
DS
CL1,CL1
ZFLD,
HL2 BINARY-DATE(MUST
CL1,CL1
ZFLD,
HL2 BINARY-DATE(MUST
CL1,CL1
ZFLD,
HL2 BINARY-DATE(MUST
000712
000713
000714
1289 GDATEB
1290+GDATEB_Z
1291+GDATEB_T
1292+GDATEB
1294 GNUMB
1295+GNUMB_Z
1296+GNUMB_T
1297+GNUMB
GFLD
DS
DS
DS
GFLD
DS
DS
DS
HL2
CL1
CL1
HL2
FL4
CL1
CL1
FL4
000718
00071A
00071F
000721
000726
000728
000739
00073B
00074B
00074D
000759
00075B
000763
000765
1299
1300
1301
1302
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
DS
CL1,CL1
ZFLD, TFLD
HL2 BINARY-DATE(MUST BE H, HL2)
CL1,CL1
ZFLD, TFLD
FL4 BINARY ITEM(MUST BE F, FL4)
CL1,CL1
ZFLD, TFLD
PL5 PACKED FIELD (WATCH LENGTH)
CL1,CL1
ZFLD, TFLD
ZL5 NUMERIC (MUST = LEN OF SOURCE)
CL1,CL1
ZFLD, TFLD
CL17
CHAR.(MUST = LEN OF SOURCE)
CL1,CL1
ZFLD, TFLD
CL16
CHAR.(MUST = LEN OF SOURCE)
CL1,CL1
ZFLD, TFLD
CL12
CHAR.(MUST = LEN OF SOURCE)
CL1,CL1
ZFLD, TFLD
CL8
CHAR.(MUST = LEN AS SOURCE)
CL1,CL1
ZFLD, TFLD
CL3
CHAR.(MUST = LEN AS SOURCE)
00070E
00070F
000710
*
*GDATEB
*
*GNUMB
GNUMP
GNUMZ
GCHAR
GLAST
GFIRST
GMIDDLE
GPREF
Chapter Six - LXTABLE Processing
TFLD
BE H OR HL2)
TFLD
BE H OR HL2)
TFLD
BE H OR HL2)
ZFIELD
TFIELD
DATA FIELD
ZFIELD
TFIELD
DATA FIELD
120
00590000
00600000
00610000
00620000
00630000
00640000
00660007
01-00873
01-00874
01-00875
00680007
01-00873
01-00874
01-00875
00700007
00710007
00720007
00730007
00750000
00760000
00770000
00780000
00790000
0080000
0081000
0082000
0083000
0084000
0085000
0086000
0087000
0088000
Registry of Motor Vehicles – UMS Programmer’s Manual
000768
00076A
00076B
00076D
000774
000776
00077C
00077E
00079C
00079E
0007B0
0007B2
0007B4
0007B6
0007B8
0007BA
000000
000000
000040
000000
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1335
00000
00000
00004
000008
00000A
00000C
00000D
00000E
000012
000026
000028
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
DS
DS
DS
GREGNO
DS
DS
GZIPC
DS
DS
GICODE1 DS
DS
GICODE2 DS
DS
GXCODEA DS
DS
GSTATE25 DS
DS
GLICN25 DS
COPY
GCOLOR
CL1,CL1
ZFLD, TFLD
CL1
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
CL7
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
XL6
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
CL30
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
CL18
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
PL2
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
CL2
CHAR.(MUST = LEN AS
CL1,CL1
ZFLD, TFLD
CL25
CHAR.(MUST = LEN AS
UHZCOMMA
SOURCE)
SOURCE)
SOURCE)
SOURCE)
SOURCE)
SOURCE)
SOURCE)
SOURCE)
***** UMS COMMON-AREA, HOST SIDE. ** ECE ***
UHCOMMON DSECT
UHCPROTO DS
XL64
SYSTEM PROTOCALL DATA
ORG
UHCPROTO
UHCDTEMP DS
D
GENERAL PURPOSE DBL-WORD TEMP.
UHCPARM1 EQU
UHCDTEMP,4 SPECIAL-PURPOSE PARM-1
UHCPARM2 EQU
UHCDTEMP+4,4 SPECIAL-PURPOSE PARM-2
UHCCLENG DS
H
LENGTH FOR USE WITH XCTL.
UHCRDLEN DS
H
RESPONSE DETAIL LENGTH
UHCEFLAG DS
XL1
ENTRY-REASON.
X'FF'=DUPKEY RESOLUTION
DS
XL1
FILLER
UHCDUPNM DS
CL4 HOLD DUPKEY NAME BY DISPATCHER
UFHPINS2 DS
10PL2 ADDED INSURNACE-CODE LIST
UHPCTIND DS
H
HOST PCT INDEX. X'FFFF' = NONE
UHSTARTT DS
D
R/T CLOCK AT UHZ0001P INITI.
Chapter Six - LXTABLE Processing
121
0089000
0090000
0091000
0092000
0093000
0094000
0095000
0096000
0097000
0098000
0099000
0100000
0101000
0102000
0103000
0104000
01060000
00020000
00030000
00040000
00050000
00060000
00070000
00080000
00090000
00100000
00110000
00120000
00130000
00140000
00150000
00160000
Registry of Motor Vehicles – UMS Programmer’s Manual
000030
000040
000100
000040
000048
000048
000050
000A30
00040
00170000
00180000
00190000
00200000
00210000
00220000
00230000
01170000
01180000
01070000
00023E
ORG
UHCMODNA DS
XL192
MODULE NAME AREA
ORG
UHCMODNA
UHCOUTPR DS
CL8
O/P-SIDE PROTOCALL PROCESSOR
UHCMODX DS
0CL(4*8)
MODULES FROM PCTE ENTRY
UHCMOD1 DS
CL8
1ST APPLIC. PROCESSOR MODULE
UHCMOD2 DS
CL8
2ND APPLIC. PROCESSOR MODULE
ORG
UHCOMLEN EQU
*-UHCOMMON
COMMON LENGTH
ORG
UHCIDATA
* OUTPUT-ONLY HOSTAREA FIELDS GO HERE.
*
THERE ARE NO ZFLD OR TFLD BYTES.
1456 * THE AREAS ARE NOT SENT
*
IF THEY ARE LOW-VALUES.
1457 HCHAR
DS
CL10
000248
1458 HXCODEB
01110000
00040
00C00
00C00
0023E
000C00
000000
00000
00000
000000
000008
00000F
000018
00001D
D3E7E3C1C2E3E2E3
E4C7D3E3C5E2E3
F0F761F0F961F9F1
F1F54BF4F7
00000000
1352
1353
1354
1355
1356
1357
1358
1452
1453
1454
1455
DS
PL2
CHAR.(MUST BE = LEN AS SOURCE)
1461 * DEFINE THE TABLE. SPECIFY CSECT-NAME IN
*
IDENTIFICATION FIELD
1462 * AND MAP-NAME
1464 LXTABTST UMSLXTBL TYPE=START,MAPNAME=UGLTEST,
LEVEL0=NO
1465+LXTABTST START 0
1466+
PUSH PRINT
1467+
PRINT OFF
1484+
POP
PRINT
1485+
USING MAPINP,R4
1486+
USING UGCOMMON,R9
1487+
DC
CL8'LXTABTST'
1488+
DC
CL7'UGLTEST'
1489+
DC
CL8'07/09/91',CL1' '
1490+
DC
CL5'15.47'
1491+
DC
XL4'0'
Chapter Six - LXTABLE Processing
122
01080000
01090000
01100000
01140008
01150008
X01170009
01-00090
01-00091
01-00092
01-00110
01-00111
01-00112
01-00113
01-00114
01-00115
01-00116
01-00117
Registry of Motor Vehicles – UMS Programmer’s Manual
000021 00
000022 000000
000025 FFFF
000027
000025
000027
000028
000029
00002B
00002D
00002F
00002F
000118
000118
000119
00011C
000120
000033
000033
000035
000033
000035
000036
000037
000039
00003B
00003D
00025
0E08
20
02
0726
005D
1010
00000118
08
000001
00000025
FFFF
00033
0A08
08
00
003C
0071
0909
FFFF
1492+
DC
BL1'00000000'
FLAGS
01-00118
1493+
DC
XL3'0'
RESERVED
01-00119
1494+
DC
XL2'FFFF'
TEMP TRAILER
01-00120
1496 *
01190008
1497 * EXAMPLE: CHARACTER TO CHARACTER, FIELDS MUST BE SAME LENGTH
1499
UMSLXTBL MAPFLD=MCHAR,GSAFLD=GCHAR,EDIT=VIN,KEYFLD=1
1500+
ORG
*-2
01-00345
1501+G$GCHAR DC
AL1(L0005-*),AL1(008)
01-00346
1502+M$MCHAR DC
BL1'00100000'
01-00347
1503+
DC
BL1'00010'
01-00348
1504+
DC
AL2(GCHAR-UGCOMMON-2)
01-00349
1505+
DC
AL2(MCHAR-MAPINP-3)
01-00350
1506+
DC
AL1(L'GCHAR-1),AL1(L'MCHAR-1)
01-00351
1507+E$GCHAR DS
0AL1
DEFINE REFERENCE
02-00531
1508+
DC
AL4(E0006)
POINT TO EDIT ARRAY
02-00535
1509+CSECT2
CSECT
02-00536
1510+E0006
DC
AL1(L0006-*)
LENGTH OF ARRAY
02-00537
1511+
DC
AL1(00),AL2(1) MODE FLAG BITS / TYPE 02-00755
1512+
DC
AL4(G$GCHAR)
REFERENCE TO LXTBL BLOCK
1513+L0006
DS
0AL1
END OF ARRAY
02-00770
1514+LXTABTST CSECT
02-00771
1515+L0005
DC
XL2'FFFF'
01-00361
1517 *
01240008
1518 * EXAMPLE: CHARACTER TO CHARACTER,
*
FIELDS MUST BE SAME LENGTH, OUTPUT
01250008
1520
UMSLXTBL MAPFLD=MCHAR2,HOSTFLD=HCHAR
01270008
1521+
ORG
*-2
01-00345
1522+
DC
AL1(L0007-*),AL1(008)
01-00346
1523+M$MCHAR2 DC
BL1'00001000'
01-00347
1524+
DC
BL1'00000'
01-00348
1525+
DC
AL2(HCHAR-UHCITEXT-2)
01-00349
1526+
DC
AL2(MCHAR2-MAPINP-3)
01-00350
1527+
DC
AL1(L'HCHAR-1),AL1(L'MCHAR2-1)
01-00351
1528+L0007
DC
XL2'FFFF'
01-00361
Chapter Six - LXTABLE Processing
123
Registry of Motor Vehicles – UMS Programmer’s Manual
00003F
00003D
00003F
000040
000041
000043
000045
000047
000120
000120
000121
000122
000124
000127
00012A
00012D
00004B
00004B
0003D
0E00
11
00
071F
00AB
0404
00000120
01
03
0004
00001C
00002C
00003C
45670C
FFFF
000000
000000
000002
000003
000007
00001
00002
1530 *
01290008
1531 * EXAMPLE: NUMERIC TO NUMERIC, FIELDS MUST BE SAME LENGTH
1533
UMSLXTBL MAPFLD=MNUM1,GSAFLD=GNUMZ,
VALUE=(RALLOW,1,2,3,45670)
01320008
1534+
ORG
*-2
01-00345
1535+G$GNUMZ DC
AL1(L0008-*),AL1(000)
01-00346
1536+M$MNUM1 DC
BL1'00010001'
01-00347
1537+
DC
BL1'00000'
01-00348
1538+
DC
AL2(GNUMZ-UGCOMMON-2)
01-00349
1539+
DC
AL2(MNUM1-MAPINP-3)
01-00350
1540+
DC
AL1(L'GNUMZ-1),AL1(L'MNUM1-1)
01-00351
1541+
DC
AL4(V0009)
POINT TO VALUE LIST
02-00431
1542+CSECT2
CSECT
02-00432
1543+V0009
DC
BL1'0001'
FLAGS
02-00436
1544+
DC
AL1(3)
TRUE ENTRY LENGTH
02-00437
1545+
DC
AL2(4)
NUMBER OF LIST ELEMENTS02-00438
1546+
DC
PL3'1'
02-00473
1547+
DC
PL3'2'
02-00473
1548+
DC
PL3'3'
02-00473
1549+
DC
PL3'45670'
02-00473
1550+LXTABTST CSECT
02-00478
1551+L0008
DC
XL2'FFFF'
01-00361
1553 *
01340008
1554 * EXAMPLE: NUMERIC TO PACKED, OUTPUT MUST BE LONG-ENOUGH
1556
UMSLXTBL MAPFLD=MNUM2,GSAFLD=GNUMP,
X
OPTION1=LZFILL,EXIT=USER01,KEYFLD=4 01370008
1557+EXITDATA DSECT
02-00909
1558+EXITCODE DS
AL2
UNIQUE IDENTIFIER CODE SC1290 02-00910
1559+EXITWHYS DS
XL1
SUMMATION OF ENTRY REASONS
02-00911
1560+EXITRETN DS
AL4
RETURN ADDRESS
SC1290 02-00912
1561+EXITWHYX DS
XL1
REASON FOR THIS ENTRY SC1290 02-00913
1562+EXRVALOK EQU
B'00000001'
VALUE IS OK
SC1290 02-00914
1563+EXRVALNG EQU
B'00000010'
VALUE IS NOT OK SC1290 02-00915
Chapter Six - LXTABLE Processing
124
Registry of Motor Vehicles – UMS Programmer’s Manual
00004
00008
00010
000008
000008
00000
00001
00002
000009
00004D
00004D
00004B
00004D
00004E
00004F
000051
000053
000055
0004B
1104
81
18
0718
00B3
0406
00000198FFFFFF
00005C FFFF
00005E
00005C
00005E
00005F
000060
000062
000064
0005C
0A0C
01
03
0712
00BD
0303
1564+EXREDTOK EQU
B'00000100'
EDIT IS OK
SC1290 02-00916
1565+EXREDTNG EQU
B'00001000'
EDIT IS NOT OK SC1290 02-00917
1566+EXRALWAY EQU
B'00010000' ALWAYS ENTER UNLESS FMT ERR02-00918
1567+EXITUSER DS
0XL5
USER PARMS
SC1290 02-00919
1568+EXITACTN DS
XL1
USER ACTION REQUEST
SC1290 02-00920
1569+EXANOACT EQU
B'00000000' CONTINUE, NO ACTION SC1290 02-00921
1570+EXANOERR EQU
B'00000001' CONTINUE, NO ERROR SC1290 02-00922
1571+EXAWIERR EQU
B'00000010' CONTINUE, POST ERR. SC1290 02-00923
1572+EXITEROR DS
XL4
USER ERROR CODE
SC1290 02-00924
1573+LXTABTST CSECT
02-00925
1574+UMSLXTBL/EXIT REASON DEFAULTED TO ALL (FF)
02-00933
1575+UMSLXTBL/EXIT LOCATION-CODE DEFAULTED TO 65535
02-00965
1576+
ORG
*-2
01-00345
1577+G$GNUMP DC
AL1(L0010-*),AL1(004)
01-00346
1578+M$MNUM2 DC
BL1'10000001'
01-00347
1579+
DC
BL1'11000'
01-00348
1580+
DC
AL2(GNUMP-UGCOMMON-2)
01-00349
1581+
DC
AL2(MNUM2-MAPINP-3)
01-00350
1582+
DC
AL1(L'GNUMP-1),AL1(L'MNUM2-1)
01-00351
1583+
DC
AL4(USER01),XL1'FF',AL2( 5535)
X01-00359
+
EXIT STRING VALUE
1584+L0010
DC
XL2'FFFF'
01-00361
1586 *
01390008
1587 * EXAMPLE: NUMERIC TO BINARY, I/P MUST BE 1-9 DIGITS 01400008
1588 * OUTPUT MUST BE F OR FL4
01410008
1589
UMSLXTBL MAPFLD=MNUM3,GSAFLD=GNUMB,OPTION1=RTJUST,
KEYFLD=1
1590+
ORG
*-2
01-00345
1591+G$GNUMB DC
AL1(L0012-*),AL1(012)
01-00346
1592+M$MNUM3 DC
BL1'00000001'
01-00347
1593+
DC
BL1'00011'
01-00348
1594+
DC
AL2(GNUMB-UGCOMMON-2)
01-00349
1595+
DC
AL2(MNUM3-MAPINP-3)
01-00350
1596+
DC
AL1(L'GNUMB-1),AL1(L'MNUM3-1)
01-00351
Chapter Six - LXTABLE Processing
125
Registry of Motor Vehicles – UMS Programmer’s Manual
000066 FFFF
000068
000066
000068
000069
00006A
00006C
00006E
000070
000130
000130
000131
000132
000134
000136
000138
00013A
000074
000074
000074
00013C
00013C
00013D
000140
000144
000078
000078
00066
1910
32
10
0702
00C4
0109
00000130
04
02
0004
0000
8000
7FFF
FFFF
0000013C
08
000012
00000066
000001B8010063
00007F FFFF
1597+L0012
DC
XL2'FFFF'
01-00361
1599 *
01440008
1600 * EXAMPLE: DATE, INPUT MUST BE CL10, OUTPUT MUST BE H OR HL2
1602
UMSLXTBL MAPFLD=MDATE,GSAFLD=GDATE,EDIT=AGE1600,
VALUE=(ALLOW,8000,0000,FFFF,7FFF),
EXIT=(USER02,01,99)
01480008
1603+
ORG
*-2
01-00345
1604+G$GDATE DC
AL1(L0013-*),AL1(016)
01-00346
1605+M$MDATE DC
BL1'00110010'
01-00347
1606+
DC
BL1'10000'
01-00348
1607+
DC
AL2(GDATE-UGCOMMON-2)
01-00349
1608+
DC
AL2(MDATE-MAPINP-3)
01-00350
1609+
DC
AL1(L'GDATE-1),AL1(L'MDATE-1)
01-00351
1610+
DC
AL4(V0015)
POINT TO VALUE LIST
02-00431
1611+CSECT2
CSECT
02-00432
1612+V0015
DC
BL1'0100'
FLAGS
02-00436
1613+
DC
AL1(2)
TRUE ENTRY LENGTH
02-00437
1614+
DC
AL2(4)
NUMBER OF LIST ELEMENTS02-00438
1615+
DC
AL2(X'8000'+32768)
02-00473
1616+
DC
AL2(X'0000'+32768)
02-00473
1617+
DC
AL2(X'FFFF'+32768)
02-00473
1618+
DC
AL2(X'7FFF'+32768)
02-00473
1619+LXTABTST CSECT
02-00478
1620+E$GDATE DS
0AL1
DEFINE REFERENCE
02-00531
1621+
DC
AL4(E0016)
POINT TO EDIT ARRAY
02-00535
1622+CSECT2
CSECT
02-00536
1623+E0016
DC
AL1(L0016-*)
LENGTH OF ARRAY
02-00537
1624+
DC
AL1(00),AL2(18) MODE FLAG BITS / TYPE 02-00755
1625+
DC
AL4(G$GDATE)
REFERENCE TO LXTBL BLK 02-00766
1626+L0016
DS
0AL1
END OF ARRAY
02-00770
1627+LXTABTST CSECT
1628+
DC
AL4(USER02),XL1'01',AL2(99)
X01-00359
+
EXIT STRING VALUE
1629+L0013
DC
XL2'FFFF'
01-00361
Chapter Six - LXTABLE Processing
126
Registry of Motor Vehicles – UMS Programmer’s Manual
000081
00007F
000081
000082
000083
000085
000087
000089
00008B
000089
00008B
00008C
00008D
00008F
000091
000093
000095
000093
000095
000096
000097
000099
00009B
00009D
0A14
04
00
0706
00D1
0106
FFFF
1631 * EXAMPLE: EXPDATE, INPUT MUST BE CL7,
*
OUTPUT MUST BE H OR HL2
1633
UMSLXTBL MAPFLD=MDATE2,GSAFLD=GDATE2
1634+
ORG
*-2
1635+G$GDATE2 DC
AL1(L0017-*),AL1(020)
1636+M$MDATE2 DC
BL1'00000100'
1637+
DC
BL1'00000'
1638+
DC
AL2(GDATE2-UGCOMMON-2)
1639+
DC
AL2(MDATE2-MAPINP-3)
1640+
DC
AL1(L'GDATE2-1),AL1(L'MDATE2-1)
1641+L0017
DC
XL2'FFFF'
01520008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
0A08
00
00
0763
00F5
0202
FFFF
1643 * EXAMPLE: COMPLETE SET FOR REGISTRATION
1645
UMSLXTBL MAPFLD=MPREF,GSAFLD=GPREF
1646+
ORG
*-2
1647+G$GPREF DC
AL1(L0018-*),AL1(008)
1648+M$MPREF DC
BL1'00000000'
1649+
DC
BL1'00000'
1650+
DC
AL2(GPREF-UGCOMMON-2)
1651+
DC
AL2(MPREF-MAPINP-3)
1652+
DC
AL1(L'GPREF-1),AL1(L'MPREF-1)
1653+L0018
DC
XL2'FFFF'
01540008
01560008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
1655
1656+
1657+G$GCOLOR
1658+M$MCOLOR
1658+
1660+
1661+
1662+
1663+L0020
01580008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
0007F
00089
00093
0A08
00
00
0768
00FB
0000
FFFF
UMSLXTBL MAPFLD=MCOLOR,GSAFLD=GCOLOR
ORG
*-2
DC
AL1(L0019-*),AL1(008)
DC
BL1'00000000'
DC
BL1'00000'
DC
AL2(GOLOR-UGCOMMON-2)
DC
AL2(MCOLOR-MAPINP-3)
DC
AL1(L'GCOLOR-1),AL1(L'MCOLOR-1)
DC
XL2'FFFF'
Chapter Six - LXTABLE Processing
127
Registry of Motor Vehicles – UMS Programmer’s Manual
00009F
00009D
00009F
0000A0
0000A1
0000A3
0000A5
0000A7
0000A9
0000A7
0000A9
0000AA
0000AB
0000AD
0000AF
0000B1
0000B1
0000B1
000144
000144
000145
000148
00014C
000150
0000B5
0000B5
0009D
0A10
02
00
070A
00D8
0109
FFFF
000A7
0E10
22
00
070E
00E8
0109
00000144
0C
000009
0000009D
000000A7
FFFF
0000B7
0000B5 0A08
000B5
1665
1666+
1667+G$GDATEA
1668+M$MDATEA
1669+
1670+
1671+
1672+
1673+L0020
UMSLXTBL MAPFLD=MDATEA,GSAFLD=GDATEA
ORG
*-2
DC
AL1(L0020-*),AL1(016)
DC
BL1'00000010'
DC
BL1'00000'
DC
AL2(GDATEA-UGCOMMON-2)
DC
AL2(MDATEA-MAPINP-3)
DC
AL1(L'GDATEA-1),AL1(L'MDATEA-1)
DC
XL2'FFFF'
1675
1676+
1677+G$GDATEB
1678+M$MDATEB
1679+
1680+
1681+
1682+
1683+E$GDATEA
1684+E$GDATEB
1685+
1686+CSECT2
1687+E0022
1688+
1689+
1690+
1691+L0022
1692+LXTABTST
1693+L0021
UMSLXTBL MAPFLD=MDATEB,GSAFLD=GDATEB,
X01620008
EDIT=(PDATE,GDATEA,GDATEB)
01630008
ORG
*-2
01-00345
DC
AL1(L0021-*),AL1(016)
01-00346
DC
BL1'00100010'
01-00347
DC
BL1'00000'
01-00348
DC
AL2(GDATEB-UGCOMMON-2)
01-00349
DC
AL2(MDATEB-MAPINP-3)
01-00350
DC
AL1(L'GDATEB-1),AL1(L'MDATEB-1)
01-00351
DS
0AL1
DEFINE USAGE
02-00518
DS
0AL1
DEFINE USAGE
02-00518
DC
AL4(E0022)
POINT TO EDIT ARRAY
02-00535
CSECT
02-00536
DC
AL1(L0022-*)
LENGTH OF ARRAY
02-00537
DC
AL1(00),AL2(9) MODE FLAG BITS / TYPE 02-00755
DC
AL4(G$GDATEA)
REFERENCE TO LXTBL BLK 02-00762
DC
AL4(G$GDATEB)
REFERENCE TO LXTBL BLK 02-00762
DS
0AL1
END OF ARRAY
02-00770
CSECT
02-00771
DC
XL2'FFFF'
01-00361
1695
1696+
1697+G$GLAST
UMSLXTBL MAPFLD=MLAST,GSAFLD=GLAST
ORG
*-2
DC
AL1(L0023-*),AL1(008)
Chapter Six - LXTABLE Processing
128
01600008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
01650008
01-00345
01-00346
Registry of Motor Vehicles – UMS Programmer’s Manual
0000B7
0000B8
0000B9
0000BB
0000BD
0000BF
0000C1
0000BF
0000C1
0000C2
0000C3
0000C5
0000C7
0000C9
00
00
0739
007E
0F0F
FFFF
1698+M$MLAST
1699+
1700+
1701+
1702+
1703+L0023
000BF
0A08
00
00
07B8
0121
1818
FFFF
DC
DC
DC
DC
DC
DC
BL1'00000000'
BL1'00000'
AL2(GLAST-UGCOMMON-2)
AL2(MLAST-MAPINP-3)
AL1(L'GLAST-1),AL1(L'MLAST-1)
XL2'FFFF'
1705
UMSLXTBL MAPFLD=MLICN25,GSAFLD=GLICN25
1706+
ORG
*-2
1707+G$GLICN25 DC
AL1(L0024-*),AL1(008)
1708+M$MLICN25 DC
BL1'00000000'
1709+
DC
BL1'00000'
1710+
DC
AL2(GLICN25-UGCOMMON-2)
1711+
DC
AL2(MLICN25-MAPINP-3)
1712+
DC
AL1(L'GLICN25-1),AL1(L'MLICN25-1)
1713+L0024
DC
XL2'FFFF'
1715
0000CB
0000C9
0000CB
0000CC
0000CD
0000CF
0000D1
0000D3
0000D3
0000D3
000150
000150
000151
000154
000158
000C9
0E08
20
00
07B4
013D
0101
00000150
0C
00000C
000000BF
000000C9
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
01670008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
UMSLXTBL MAPFLD=MSTATE25,GSAFLD=GSTATE25,
X01690008
EDIT=(MLICN2,GLICN25,GSTATE25)
01700008
1716+
ORG
*-2
01-00345
1717+G$GSTATE25 DC AL1(L0025-*),AL1(008)
01-00346
1718+M$MSTATE25 DC BL1'00100000'
01-00347
1719+
DC
BL1'00000'
01-00348
1720+
DC
AL2(GSTATE25-UGCOMMON-2)
01-00349
1721+
DC
AL2(MSTATE25-MAPINP-3)
01-00350
1722+
DC
AL1(L'GSTATE25-1),AL1(L'MSTATE25-1)
01-00351
1723+E$GLICN25 DS
0AL1
DEFINE USAGE
02-00518
1724+E$GSTATE25 DS 0AL1
DEFINE USAGE
02-00518
1725+
DC
AL4(E0026)
POINT TO EDIT ARRAY
02-00535
1726+CSECT2
CSECT
02-00536
1727+E0026
DC
AL1(L0026-*)
LENGTH OF ARRAY
02-00537
1728+
DC
AL1(00),AL2(12) MODE FLAG BITS / TYPE 02-00755
1729+
DC
AL4(G$GLICN25) REFERENCE TO LXTBL BLK 02-00762
1730+
DC
AL4(G$GSTATE25) REFERENCE TO LXTBL BLK 02-00762
Chapter Six - LXTABLE Processing
129
Registry of Motor Vehicles – UMS Programmer’s Manual
00015C
0000D7
0000D7 FFFF
0000D9
0000D7
0000D9
0000DA
0000DB
0000DD
0000DF
0000E1
1731+L0026
DS
0AL1
1732+LXTABTST CSECT
1733+L0025
DC
XL2'FFFF'
000D7
0A08
00
00
074B
0091
0B0B
FFFF
1735
1736+
1737+G$GFIRST
1738+M$MFIRST
1739+
1740+
1741+
1742+
1743+L0027
END OF ARRAY
UMSLXTBL MAPFLD=MFIRST,GSAFLD=GFIRST
ORG
*-2
DC
AL1(L0027-*),AL1(008)
DC
BL1'00000000'
DC
BL1'00000'
DC
AL2(GFIRST-UGCOMMON-2)
DC
AL2(MFIRST-MAPINP-3)
DC
AL1(L'GFIRST-1),AL1(L'MFIRST-1)
DC
XL2'FFFF'
1745
0000E3
0000E1
0000E3
0000E4
0000E5
0000E7
0000E9
0000EB
0000EB
0000EB
0000EB
00015C
00015C
00015D
000160
000164
000168
00016C
000E1
0E08
20
00
0759
00A0
0707
0000015C
10
00000A
000000B5
000000D7
000000E1
02-00770
02-00771
01-00361
01720008
01-00345
01-00346
01-00347
01-00348
01-00349
01-00350
01-00351
01-00361
UMSLXTBL MAPFLD=MMIDDLE,GSAFLD=GMIDDLE,
X01740008
EDIT=(PNAME,GLAST,GFIRST,GMIDDLE)
01750008
1746+
ORG
*-2
01-00345
1747+G$GMIDDLE DC
AL1(L0028-*),AL1(008)
01-00346
1748+M$MMIDDLE DC
BL1'00100000'
01-00347
1749+
DC
BL1'00000'
01-00348
1750+
DC
AL2(GMIDDLE-UGCOMMON-2)
01-00349
1751+
DC
AL2(MMIDDLE-MAPINP-3)
01-00350
1752+
DC
AL1(L'GMIDDLE-1),AL1(L'MMIDDLE-1)
01-00351
1753+E$GLAST DS
0AL1
DEFINE USAGE
02-00518
1754+E$GFIRST DS
0AL1
DEFINE USAGE
02-00518
1755+E$GMIDDLE DS
0AL1
DEFINE USAGE
02-00518
1756+
DC
AL4(E0029)
POINT TO EDIT ARRAY
02-00535
1757+CSECT2
CSECT
02-00536
1758+E0029
DC
AL1(L0029-*)
LENGTH OF ARRAY
02-00537
1759+
DC
AL1(00),AL2(10) MODE FLAG BITS / TYPE 02-00755
1760+
DC
AL4(G$GLAST)
REFERENCE TO LXTBL BLK 02-00762
1761+
DC
AL4(G$GFIRST)
REFERENCE TO LXTBL BLK 02-00762
1762+
DC
AL4(G$GMIDDLE) REFERENCE TO LXTBL BLK 02-00762
1763+L0029
DS
0AL1
END OF ARRAY
02-00770
Chapter Six - LXTABLE Processing
130
Registry of Motor Vehicles – UMS Programmer’s Manual
0000EF
0000EF FFFF
1764+LXTABTST CSECT
1765+L0028
DC
XL2'FFFF'
1767
0000F1
0000EF
0000F1
0000F2
0000F3
0000F5
0000F7
0000F9
0000F9
0000F9
0000F9
00016C
00016C
00016D
000170
000174
000178
00017C
0000FD
0000FD
0000FF
0000FD
0000FF
000100
000101
000103
000105
000107
000EF
0E08
20
00
076B
00FF
0606
0000016C
10
000004
00000089
00000093
000000EF
FFFF
000FD
0A18
40
00
0774
0109
0509
FFFF
1768+
1769+G$GREGNO
1770+M$MREGNO
1771+
1772+
1773+
1774+
1775+E$GPREF
1776+E$GCOLOR
1777+E$GREGNO
1778+
1779+CSECT2
1780+E0031
1781+
1782+
1783+
1784+
1785+L0031
1786+LXTABTST
1787+L0030
1789
1790+
1791+G$GZIPC
1792+M$MZIPC
1793+
1794+
1795+
1796+
1797+L0032
02-00771
01-00361
UMSLXTBL MAPFLD=MREGNO,GSAFLD=GREGNO,
X01770008
EDIT=(REGNO,GPREF,GCOLOR,GREGNO)
01780008
ORG
*-2
01-00345
DC
AL1(L0030-*),AL1(008)
01-00346
DC
BL1'00100000'
01-00347
DC
BL1'00000'
01-00348
DC
AL2(GREGNO-UGCOMMON-2)
01-00349
DC
AL2(MREGNO-MAPINP-3)
01-00350
DC
AL1(L'GREGNO-1),AL1(L'MREGNO-1)
01-00351
DS
0AL1
DEFINE USAGE
02-00518
DS
0AL1
DEFINE USAGE
02-00518
DS
0AL1
DEFINE USAGE
02-00518
DC
AL4(E0031)
POINT TO EDIT ARRAY
02-00535
CSECT
02-00536
DC
AL1(L0031-*)
LENGTH OF ARRAY
02-00537
DC
AL1(00),AL2(4) MODE FLAG BITS / TYPE 02-00755
DC
AL4(G$GPREF)
REFERENCE TO LXTBL BLK 02-00762
DC
AL4(G$GCOLOR)
REFERENCE TO LXTBL BLK 02-00762
DC
AL4(G$GREGNO)
REFERENCE TO LXTBL BLK 02-00762
DS
0AL1
END OF ARRAY
02-00770
CSECT
02-00771
DC
XL2'FFFF'
01-00361
UMSLXTBL MAPFLD=MZIPC,GSAFLD=GZIPC
01800008
ORG
*-2
01-00345
DC
AL1(L0032-*),AL1(024)
01-00346
DC
BL1'01000000'
01-00347
DC
BL1'00000'
01-00348
DC
AL2(GZIPC-UGCOMMON-2)
01-00349
DC
AL2(MZIPC-MAPINP-3)
01-00350
DC
AL1(L'GZIPC-1),AL1(L'MZIPC-1)
01-00351
DC
XL2'FFFF'
01-00361
Chapter Six - LXTABLE Processing
131
Registry of Motor Vehicles – UMS Programmer’s Manual
000109
00001D
000021
000188
000188
000109
000189
000189
000188
00018A
00018C
00018E
000109
00018F
00018F
00018E
000190
000192
000194
000109
000109
000107
000109
00010A
00010B
00010D
00010F
000111
0001D
00000188
00109
01
00188
0000
07B0
077C
01
0018E
0201
0046
079C
01
00107
0E08
20
00
06F8
0116
0707
1799
UMSLXCON GSAINP=GXCODEA,GSAOUT=GICODE1,TYPE=ICODE
1800+
ORG
LXTABTST+X'1D'
01-00830
1801+
DC
AL4(CONTABLE)
CONVERSION TABLE PTR
01-00831
1802+
ORG
01-00832
1803+CSECT3
CSECT
01-00833
1804+CONTABLE DC
BL1'00000001'
SET END LAG
01-00834
1805+LXTABTST CSECT
01-00835
1806+CSECT3
CSECT
01-00837
1807+
ORG
*-1
01-00838
1808+
DC
BL1'00',AL1(0)
01-00839
1809+S#GXCODEA DC AL2(GXCODEA-UGCOMMON-2)
01-00840
1810+
DC
AL2(GICODE1-UGCOMMON-2)
01-00841
1811+T#GICODE1 DC
BL1'00000001'
01-00842
1812+LXTABTST CSECT
01-00843
1814
UMSLXCON HOSTINP=HXCODEB,GSAOUT=GICODE2,TYPE=ICODE
1815+CSECT3
CSECT
01-00837
1816+
ORG
*-1
01-00838
1817+
DC
BL1'10',AL1(1)
01-00839
1818+S#HXCODEB DC AL2(HXCODEB-UHCITEXT-2)
01-00840
1819+
DC
AL2(GICODE2-UGCOMMON-2)
01-00841
1820+T#GICODE2 DC
BL1'00000001'
01-00842
1821+LXTABTST CSECT
01-00843
1823
UMSLXTBL MAPFLD=MTITLE#,GSAFLD=GTITLE#,EDIT=TITLE#
1824+
ORG
*-2
01-00345
1825+G$GTITLE# DC
AL1(L0035-*),AL1(008)
01-00346
1826+M$MTITLE# DC
BL1'00100000'
01-00347
1827+
DC
BL1'00000'
01-00348
1828+
DC
AL2(GTITLE#-UGCOMMON-2)
01-00349
1829+
DC
AL2(MTITLE#-MAPINP-3)
01-00350
1830+
DC
AL1(L'GTITLE#-1),AL1(L'MTITLE#-1)
01-00351
1831+E$GTITLE# DS
0AL1
DEFINE REFERENCE
02-00531
Chapter Six - LXTABLE Processing
132
Registry of Motor Vehicles – UMS Programmer’s Manual
000111
00017C
00017C
00017D
000180
000184
000115
000115
0000017C
08
000008
00000107
FFFF
000198
00000
00000
00198
000198
000198
00019E
0001A2
0001A6
0001AA
0001AE
0001AE
D603
4780
910A
4780
9201
96C0 96C0 006C0 006C0
C016
001AE
8007
00007
C016
001AE
8008
00008
BFEF 8003
00003
1832+
DC
AL4(E0036)
POINT TO EDIT ARRAY
1833+CSECT2
CSECT
1834+E0036
DC
AL1(L0036-*)
LENGTH OF ARRAY
1835+
DC
AL1(00),AL2(8) MODE FLAG BITS / TYPE
1836+
DC
AL4(G$GTITLE#) REFERENCE TO LXTBL BLK
1837+L0036
DS
0AL1
END OF ARRAY
1838+LXTABTST CSECT
1839+L0035
DC
XL2'FFFF'
1841 ****************************************************
1842 **
**
1843 **
USER EXITS: ALL GO HERE,
**
**
AT THE END OF THE LXTABLE
**
1844 **
**
1845 **
NOTE: LEADING 'DROP' IS VERY IMPORTANT
**
1846 ****************************************************
1848
DROP
1849 UGLTEST1 CSECT
1850
USING UGCOMMON,R9
COMMON AREA
1851
USING EXITDATA,R8
EXIT DATA
*****************************************************
1853 * THIS EXAMPLE WILL FORCE NO-ERROR IF THERE
**
* IS AN EXISTING ERROR AND WE HAVE BEEN
**
* ENTERED FOR THE REASON OF AN ERROR. IN ANY
**
1855 * OTHER CASE, NORMAL FLOW WILL BE OBSERVED
**
*****************************************************
1857
USING USER01,R12
ROUTINE BASE
1858 USER01
DS
0H
1859
OC
UGGERRCD,UGGERRCD
PREVIOUS ERROR?
1860
BZ
U19999
NO
1861
TM
EXITWHYX,EXRVALNG+EXREDTNG ERROR ?
1862
BZ
U19999
NO
1863
MVI
EXITACTN,EXANOERR
YES, FORCE ERROR
1865 U19999
DS
0H
1866
ICM
R14,B'1111',EXITRETN GET RTN ADDRESS
Chapter Six - LXTABLE Processing
133
02-00535
02-00536
02-00537
02-00755
02-00766
02-00770
02-00771
01-00361
01880001
01890001
01900001
01910001
01920006
01930001
01950006
01960000
01970000
01980000
02040000
02050000
02060000
02070000
02080000
02090000
02100000
02120000
02130000
Registry of Motor Vehicles – UMS Programmer’s Manual
0001B2 07FE
0001B8
00000
00000
1867
1869
1871
1872
1873
1875
1876
001B8
0001B8
0001B8
0001BE
0001C2
0001C6
0001CA
0001D0
0001D4
0001DA
0001DE
0001DE
LOC
D501
4770
955B
4770
D50F
4770
D203
9202
9704 C034 00704 001EC
C026
001DE
9728
00728
C026
001DE
9729 9728 00729 00728
C026
001DE
8009 C030 00009 001E8
8008
00008
BFEF 8003
00003
1878
1880
1881
1882
1883
1884
1885
1886
1887
1888
1890
1891
BR
R14
LTORG
DROP
USING UGCOMMON,R9
USING EXITDATA,R8
EXIT
COMMON AREA
EXIT DATA
****************************************************
* THIS EXAMPLE WILL FORCE AN ERROR IF
**
* GDATE = X'7FFF' AND GCHAR = ALL '$'
**
* IN ANY OTHER CASE, NORMAL FLOW WILL BE OBSERVED **
****************************************************
USING USER02,R12
ROUTINE BASE
USER02
DS
0H
CLC
GDATE,=X'7FFF'
7FFF?
BNE
U29999
NO
CLI
GCHAR,C'$'
1ST BYTE OF GCHAR=$?
BNE
U29999
NO
CLC
GCHAR+1(L'GCHAR-1),GCHAR
REST=$?
BNE
U29999
NO
MVC
EXITEROR,=F'123456789' SET ERROR-CODE
MVI
EXITACTN,EXAWIERR
FORCE ERROR
U29999
DS
0H
ICM
R14,B'1111',EXITRETN
GET RTN ADDRESS
LXTABTST - UMS SAMPLE LXTBL DEFINITION
OBJECT CODE
ADDR1 ADDR2 STMT
SOURCE STATEMENT
0001E2 07FE
0001E8
0001E8 075BCD15
0001EC 7FFF
1892
1894
1895
1896
1897
1899
02140000
02160000
02180000
02190000
02200000
BR
R14
LTORG
=F'123456789'
=X'7FFF'
DROP
END
Chapter Six - LXTABLE Processing
02220000
02230000
02250000
02270000
02280000
02290000
02300000
02310000
02320000
02330000
02340000
02350000
02370000
02380000
PAGE
20
ASM H V 02 15.47 07/09/91
EXIT
02390000
02410000
02420000
02440000
134
Registry of Motor Vehicles – UMS Programmer’s Manual
MVS/XA DFP VER 2 LINKAGE EDITOR
15:47:57
JOB RMCJEBBX
STEP STEP010
PROCEDURE LKED
INVOCATION PARAMETERS - LIST,XREF
ACTUAL SIZE=(317440,79872)
OUTPUT DATA SET RMVMV.UMS.RMCJEBB IS ON VOLUME RELP02
TUE
JUL 09, 1991
CROSS REFERENCE TABLE
CONTROL SECTION
ENTRY
NAME
LXTABTST
CSECT2
CSECT3
UGLTEST1
ORIGIN
00
118
188
198
LENGTH
117
6C
D
56
LOCATION
2F
70
B1
EB
111
55
11C
148
154
160
168
174
180
REFERS TO SYMBOL IN CONTROL SECTION
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
UGLTEST1
UGLTEST1
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LOCATION
47
74
D3
F9
1D
78
140
14C
158
164
170
178
REFERS TO
Chapter Six - LXTABLE Processing
SYMBOL IN CONTROL SECTI
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT2
CSECT3
CSECT3
UGLTEST1
UGLTEST1
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
LXTABTST
135
Registry of Motor Vehicles – UMS Programmer’s Manual
ENTRY ADDRESS
00
TOTAL LENGTH
1F0
** LXTABTST REPLACED AND HAS AMODE 24
** LOAD MODULE HAS RMODE 24
** AUTHORIZATION CODE IS
0.
Chapter Six - LXTABLE Processing
136
Registry of Motor Vehicles – UMS Programmer’s Manual
Hexidecimal Dump of LXTABLE Example
AMASPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
DUMPT LXTABTST ALL
00110004
**CCHHR- 0011000314
RECORD LENGTH- 0001F0
000000 D3E7E3C1 C2E3E2E3 E4C7D3E3 C5E2E3F0
000020
88000000 000E0820 02072600 5D101000
000040
00071F00 AB040400 00012011 04811007
000060
071200BD 03031910 32100702 00C40109
000080
14040007 0600D101 060A0800 00076300
0000A0
00070A00 DB01090E 10220007 0E00E801
0000C0
08000007 B8012118 180E0820 0007B401
0000E0
0B0E0820 00075900 A0070700 00015C0E
000100
00077401 0905090E 08200006 F8011607
**CCHHR- 0011000314
RECORD LENGTH- 0001F0
000000
08000001 00000025 01030004 00001C00
000020
7FFFFFFF 08000012 00000066 0C000009
000040
000000C9 1000000A 000000B5 000000D7
*................*
MEMBER NAME LXTABTST CSECT NAME LXTABTST
F761F0F9 61F9F140 F1F54BF4 57000001 *LXTABTSTUGLTEST0*
*7/09/91 15.47...*
0001180A 08080000 3C007109 090E0011 *............)...*
*................*
1800B304 06000001 98FFFFFF 0A0C0101 *................*
*................*
00000130 0000013C 000001B8 0100630A *.............D..*
*................*
F502020A 08000007 6800FB00 000A1002 *......J.........*
*5...............*
09000001 440A0800 00073900 7E0F0F0A *..............Y.*
*............=...*
3D010100 0001500A 08000007 4B00910B *................*
*......&.........*
08200007 6B00FF06 06000001 6C0A1840 *..............*.*
*....,.......%.. *
07000001 7CFFFF
*............8...*
*....@..
*
MEMBER NAME LXTABTST CSECT NAME CSECT2
002C0000 3C45670C 04020004 00008000 *................*
*................*
0000009D 000000A7 0C00000C 000000BF *"...............*
*................*
000000E1 10000004 00000089 00000093 *...I...........P*
Chapter Six - LXTABLE Processing
137
Registry of Motor Vehicles – UMS Programmer’s Manual
000060
000000EF 08000008 00000107
*............
**CCHHR- 0011000314
RECORD LENGTH- 0001F0
000000
000007B0 077C0201 0046079C 01
**CCHHR- 0011000314
RECORD LENGTH- 0001F0
000000
D60396C0 96C04780 C016910A 80074780
000020
D5019704 C0344770 C026955B 97284770
000040
C0309202 8008BFEF 800307FE 00000000
MEMBER NAME
LXTABTST
CSECT NAME CSECT3
*.....@.......
*
*
MEMBER NAME LXTABTST CSECT NAME UGLTEST1
C0169201 8008BFEF 800307FE 00000000 *O...............*
*................*
C026D50F 97299728 4770C026 D2038009 *N..........$....*
*..N.........K...*
075BCD15 7FFF
*................*
*.$..".
*
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I AMASPZAP PROCESSING COMPLETED
******************************** BOTTOM OF DATA ********************************
Chapter Six - LXTABLE Processing
138
Registry of Motor Vehicles – UMS Programmer’s Manual
7
System Utility Programs
Resident Utilities
The Guest System Utilities are divided between non-resident and resident. The nonresident routines require access to large tables, such as the one that converts
Massachusetts place names to a number and vice versa. Their functionality will be
discussed later. The resident utilities are sections in the module UGZ0003P which is
loaded into memory at system start-up. The addresses of the entry points for each of the
routines in the module is placed in the Guest Common Area at transaction start-up by the
UMS System Control Program, UGZ0001P.
This is another example of “soft linkage” between system and application. The utilities
may be changed in virtually any way and the application will need no maintenance for it.
In addition, where the utilities are not hard-linked to the application, the size of the
application module is kept to a minimum. The linkage is achieved through a small
routine, UICALLST, which must be hard-linked to the application program. Do not try
any kind of direct calls. The coding is simple and is as follows for COBOL:
CALL 'UICALLST' USING <funcaddrfld> <fldlist>.
<funcaddrfld> parameter is the name of the Guest Common Area field designated
for the service required. These begin at UGCOMMON-ASSISTADDRESS-AREA for COBOL and UGCAMOD1 in the Assembler
version. The comments or the actual field name will designate the service
provided.
<fldlist> is the name(s) of the field(s) pertaining to the service called, see the
detailed descriptions below.
Before issuing the call, one must properly initialize the Guest Common fields used by the
particular routine. Each will be mentioned, in turn.
Chapter Seven - System Utility Programs
139
Registry of Motor Vehicles – UMS Programmer’s Manual
Date Conversion Routine
The caller provides one of the three date formats, Gregorian, Julian, or internal (two-byte
binary) and the routine provides the other two. The choice is whether the user wants the
day of the week also. The Gregorian date is returned as mm/dd/yyyy. It may be given as
the 2 or 4 digit year, with or without the slashes, and the year may come first (yymmdd).
Note: The internal, binary or serial date is a two-byte binary value of the number
of days since January 1, 1940.
The data areas of interest are:
1.
2.
The FORMAT byte: this designates the form of date given and whether or not to
return day-of-week. Values allowed are 0-2 and 4-6.
Return Day-of-week
No
Yes
input
form
given
0
1
2
4
5
6
Binary
Gregorian
Julian
The return code or status byte has the following value:
0
2
4
6
8
=
=
=
=
=
OK
Non-numeric input
Invalid day of month
Invalid day of year
Format unknown
1
3
5
7
=
=
=
=
Range error
Invalid month
Invalid year
Null-date input
Example of a COBOL Invocation.
CALL 'UICALLST' USING UGCOMMON-DATE-ROUTINE ADDRESS
DFHCOMMAREA.
Chapter Seven - System Utility Programs
140
Registry of Motor Vehicles – UMS Programmer’s Manual
The Date Data-Fields
COBOL
15 UGCOMMON-DATE-AREA.
20 UGCOMMON-DATE-INPUT-FORMAT
PIC X.
20 UGCOMMON-DATE-RETURN-STATUS
PIC X.
20 UGCOMMON-DATE-BINARY-FORMAT
PIC XX.
20 UGCOMMON-DATE-JULIAN-FORMAT
PIC 9(07).
20 FILLER REDEFINES UGCOMMON-DATE-JULIAN-FORMAT.
25 UGCOMMON-DATE-JULIAN-YEAR
PIC 9(04).
25 UGCOMMON-DATE-JULIAN-DAY
PIC 9(03).
20 UGCOMMON-DATE-GREG-FORMAT-X.
25 UGCOMMON-DATE-GREG-FORMAT
PIC 9(08).
20 FILLER REDEFINES UGCOMMON-DATE-GREG-FORMAT-X.
25 UGCOMMON-DATE-GREG-YEAR
PIC 9(04).
25 UGCOMMON-DATE-GREG-MONTH
PIC 9(02).
25 UGCOMMON-DATE-GREG-DAY
PIC 9(02).
20 UGCOMMON-DATE-DAY-OF-WEEK
PIC 9.
Assembler
UGCDCONA
UGCDCFMT
UGCDCSTA
UGCDCBIN
UGCDCJUL
UGCDCGRE
UGCDCDAY
DS
DS
DS
DS
DS
DS
DS
0CL20
CL1
CL1
XL2
CL7
CL8
CL1
DATE CONVERSION AREA
INPUT FORMAT
RETURN STATUS
BINARY FORMAT
JULIAN YYYYDDD FORMAT
GREGORIAN YYYYMMDD FORMAT
DAY OF WEEK#
Data-Name Address Routine
This routine will provide full-word address (24-bit) address for a data field-name. The
calling parameters are pairs of a field-name and (then) the name of the 4-byte field. The
4-byte-field is defined as S9(9) COMP, and receives the address. A sample COBOL
invocation is:
05
05
FIELD-NAME-1
FIELD-NAME-2
PIC X(20).
PIC X.
10
10
FIELD-NAME-1-ADDR
FIELD-NAME-2-ADDR
PIC S9(9) COMP.
PIC S9(9) COMP.
Chapter Seven - System Utility Programs
141
Registry of Motor Vehicles – UMS Programmer’s Manual
CALL 'UICALLST' USING UGCOMMON-DATA-NAME-ADDRESS
FIELD-NAME-1 FIELD-NAME-1-ADDR
FIELD-NAME-2 FIELD-NAME-2-ADDR.
Upon return from the routine, the -ADDR locations hold the 24-bit address of their
‘companion fields.’ No return code is provided. If the field name is not entered first,
before the full-word name in the call, the results are guaranteed to be unpredictable.
The third and fourth function fields in the list are currently unused and will, if used, give
an immediate no-op return to your program. The fifth and sixth functions are tables for
UMS system control program use only. If these functions are invoked, a program check
will occur.
Miscellaneous Edit Services
The seventh function, UGCOMMON-MISC-TRANSLATE-TABLES, or UGCAMSTR
in assembler provides some miscellaneous edits with Upper Case Translation. The
COBOL calling sequence is:
CALL 'UICALLST' USING <comareaname><fldname>
<comareaname> is the name of the start of the guest common area.
<fldname> is the name of the field to be processed
Prior to issuing the call, one must prime UGEDCODE and UGEDLENG with the specific
service code for the field and the field's length. In all of these services, the field’s
characters are first translated from Lower to Upper case. The service codes, the implied
field-lengths and the nature of the service are as follows:
Code
Length
implied
0
none
1
9
Lower to Upper Case
translation only
Mass. Lic.# edit (len optional)
2
2
State-code edit (len optional)
3
27
Syntatic Lic#/State code edit
(len optional)
Service description
Note: If the twos-compliment of the code is passed, the translate is skipped.
Chapter Seven - System Utility Programs
142
Registry of Motor Vehicles – UMS Programmer’s Manual
In-Core Online Sort
The eighth and last routine is the core sort. The limitation is that the table to be sorted
size plus the required ‘dummy entry’ must not exceede 65,280 bytes. The routine is
called with three parameters illustrated below for COBOL:
CALL 'UICALLST' USING <ugcaddr>, <sortarea>, <sortctrl>
<ugcaddr> is the name of the start of the Common Area
<sortarea> is the name of the sort area or table to be sorted as illustrated below
<sortctrl> is the name of a 12 byte sort-descriptor data structure illustrated below
01
01
SORT-TABLE.
05 ST-ELEMENT OCCURS XX
05 ST-DUMMY
TIMES
SORT-DESCRIPTOR.
05 SD-NUM-ENTRIES
PIC X(YY).
PIC X(YY).
PIC S9(9) COMP.
( not including the 'dummy entry' )
05
05
05
05
05
(NOTE:
these
are
to
document
values
only)
88
88
88
88
88
SD-LEN-ENTRY
88 SD-GOOD-LENGTH
SD-LEN-KEY
SD-POSITION-OF-KEY
SD-SORT-TYPE
88 SD-ASCENDING
88 SD-DESCENDING
SD-STATUS-BINARY
PIC
VALUE 1 THRU
PIC
PIC
PIC
VALUE 'A'.
VALUE 'D'.
PIC
S9(4) COMP.
256.
S9(4) COMP.
S9(4) COMP.
X.
X.
SD-STATUS-OK
VALUE 0.
SD-STATUS-BAD-TYPE
VALUE 4.
SD-STATUS-BAD-ENTRY-LEN
VALUE 8.
SD-STATUS-BAD-KEY-LEN
VALUE 12.
SD-STATUS-BAD-KEY-POSN
VALUE 16.
88 SD-STATUS-TOO-MANY-ENTRIES
VALUE 20.
88 SD-STATUS-TABLE-TOO-LARGE
VALUE 24.
To inspect the status in COBOL try:
01
01
SORT-STATUS-WORK
PIC S9(4)
FILLER REDEFINES SORT-STATUS-WORK.
05 FILLER
PIC X.
05 SS-WORK
PIC X.
Chapter Seven - System Utility Programs
COMP.
143
Registry of Motor Vehicles – UMS Programmer’s Manual
MOVE ZERO
TO SORT-STATUS-WORK.
MOVE SD-STATUS-BINARY TO SS-WORK.
IF SORT-STATUS-WORK EQUAL 0
PERFORM GOOD-SORT
ELSE
PERFORM BOMB-IT.
NOTE: 88-LEVELS (not these) WOULD WORK ON SORT-STATUSBINARY.
Non-Resident Utilities
The non-resident utilities are a group of services whose satisfaction depends on entities
that are not necessarily present in memory. Fulfillment of the service may require CICS
Loads for tables or file reads to accumulate the needed resources. A separate program,
UGZ0024P, manages these services on the Guest Side. The functions or services
provided concern the Violation Table, the Court (Information) Table and the
expansion of USH Lines. They are:
Function Id
X'00'
X'01'
X'02'
X'03'
X'04'
Function
Return whole VTAB entry
Return VTAB Long Description
Return VTAB Short Description
Return Court Information
Expand Compressed USH Lines
Violation Table Processing
The parameter list requires the half-word request code or finction-id, the half-word
violation surrogate number and the address of the field to receive the data returned. If a
request code of x'00' is passed, a 115 Byte structure is returned as shown below,
otherwise only the requested description is returned.
01
VIOLATION-TABLE-RECORD.
05 VTR-SURROGATE
PIC S9(4) COMP.
05 VTR-CODE
PIC X(9).
05 VTR-FEDERAL-VIOLATION
PIC XXX.
05 VTR-LONG-DESCRIPTION
PIC X(40).
05 VTR-SHORT-DESCRIPTION
PIC X(20).
05 VTR-ACTION-GROUP OCCURS 4 TIMES.
10 VTR-ACTION
PIC X.
10 VTR-ACTION-SUBJECT
PIC X.
Chapter Seven - System Utility Programs
144
Registry of Motor Vehicles – UMS Programmer’s Manual
10
10
10
VTR-ACTION-DISCRETIONARY
VTR-ACTION-PHYS
VTR-QNTY-PERIOD
05 VTR-INDC-CRIMINAL
88 VTR-INDC-NON-CRIMINAL
88 VTR-INDC-CRIMINAL
05 VTR-INDC-MAJOR-MINOR
88 VTR-INDC-MAJOR-VIOLATION-88
88 VTR-INDC-MINOR-VIOLATION-88
05 VTR-QNTY-GRACE
05 VTR-QNTY-HTO-WEIGHT
05 VTR-QNTY-POINTS-MAX
05 VTR-QNTY-TIME-SPAN
05 VTR-CODE-VIOL-TYPE
88 VTR-CODE-OWNER-88
88 VTR-CODE-OPER-88
88 VTR-CODE-OWN-OP-88
PIC X.
PIC S9(4) COMP.
PIC 9(5) COMP-3.
PIC X.
VALUE 'N'.
VALUE 'C'.
PIC X.
VALUE '1'.
VALUE '0'.
PIC 99.
PIC 9 COMP-3.
PIC 9 COMP-3.
PIC S9(4) COMP.
PIC X.
VALUE '0'.
VALUE '1'.
VALUE '2'.
Code Fragment Example (from UGL0011P)
05
WS-VTAB-AREA.
10 WS-VTAB-FUNCTION
10 WS-VTAB-SURR
10 WS-VTAB-RETURN-ADDR
PIC S9(4) COMP.
PIC S9(4) COMP.
PIC S9(9) COMP.
MOVE +1
TO WS-VTAB-FUNCTION.
MOVE WORK-VTAB-NUMB-SURR TO WS-VTAB-SURR.
CALL 'UICALLST' USING UGCOMMON-DATA-NAME-ADDRESS
UGCOMMON-ERROR-TEXT
WS-VTAB-RETURN-ADDRESS.
The above call generates the address for the VTAB text
return area. This address is required for the next
Non-resident Service Call.
MOVE WS-VTAB-AREA TO UGCOMMON-DOUBLE-WORD-TEMP.
EXEC CICS LINK PROGRAM (UGCOMMON-NONRES-SERVICES-MOD)
COMMAREA (DFHCOMMAREA)
LENGTH
(UGCOMMON-XCTL-LENGTH)
END-EXEC.
Chapter Seven - System Utility Programs
145
Registry of Motor Vehicles – UMS Programmer’s Manual
Court Table Processing
The request for Court Information will be similar to that for the Violation Table. The
request code of X'03' returns a 71-byte structure as follows:
01 COURT-RECORD.
05 COURT-CODE
05 COURT-CITY
05 COURT-STATE
05 COURT-STREET
05 COURT-ZIP
05 COURT-NAME
PIC
PIC
PIC
PIC
PIC
PIC
999.
X(15).
XX.
X(20).
X(6).
X(25).
Compressed USH Lines Processing
This example is drawn from UGS0101P. It is similar to the above example except that
the parameter fields are in a redefine of the commarea so there is no group parameter
move to the commarea before the call to non-resident services.
01
FILLER REDEFINES DFHCOMMAREA.
05 NRS-FCODE
PIC S9(4) COMP.
05 NRS-PARM1
PIC S9(4) COMP.
05 NRS-PARM2
PIC S9(9) COMP.
05 FILLER
PIC X(4066).
1400-CALL-FOR-DETAIL.
CALL 'UICALLST' USING UGCOMMON-DATA-NAME-ADDRESS
UGS0100M-LASTBYTE-PLUS-1
1WORD-TEMP.
COMPUTE UGCOMMON-CURRENT-MAP-LENGTH =
1WORD-TEMP - MAP-POINTER.
MOVE +4 TO NRS-FCODE.
CALL 'UICALLST' USING UGCOMMON-DATA-NAME-ADRESS
UGS0100M-MDETL14-G
NRS-PARM2.
IF USH-HEADER-REQUIRED
CALL 'UICALLST' USING UGCOMMONDATA-NAME-ADDRESS
USH-DETAIL-DATA
1WORD-TEMP
ELSE
Chapter Seven - System Utility Programs
146
Registry of Motor Vehicles – UMS Programmer’s Manual
CALL 'UICALLST' USING UGCOMMONDATA-NAME-ADDRESS
USH-DETAIL-ONLY-DATA
1WORD-TEMP.
NOTE: USH-HEADER-REQUIRED is an 88-level on the byte
immediately preceeding USH-DETAIL-DATA. A 'Y' asks the
header and a 'N' says 'no'. This value must be set
before the call to NONRES services.
COMPUTE NRS-PARM1 =
1WORD-TEMP - UGCOMMON-HOST-DATA-AREA-ADDR.
EXEC CICS LINK PROGRAM (UGCOMMON-NONRES-SERVICES-MOD)
COMMAREA (DFHCOMMAREA)
LENGTH
(UGCOMMON-XCTL-LENGTH)
END-EXEC.
Chapter Seven - System Utility Programs
147
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Seven - System Utility Programs
148
Registry of Motor Vehicles – UMS Programmer’s Manual
8
CICS Tables
Under CICS, a task is an execution of one or more programs which function together as a
unit called a transaction. When a transaction is invoked, a specified application program
is loaded into storage (if it is not already) and a task is started. A special CICS table,
called the Processing Program Table (PPT), contains a list of all the valid program
names, LX tables and maps that may be executed. LX tables are unique to UMS and
each is a macro that performs field editing and mapping for a UMS screen. Each CICS
region has its own PPT. The PPT indicates to CICS the location of each program, LX
table and map, with a storage address if it has already been loaded, or a disk location if it
has not been loaded. CICS uses the PPT to determine whether it will load a new copy of
the program, LX table or map into virtual storage when the transaction is invoked.
Each time a new version of a program, LX table or map is created, it must be added to the
PPTs in each CICS region. Following are the formats of the two DFHPPT macro entries
in a PPT that are used to define a program, LX table or map:
COLUMN
COLUMN
1
|
COLUMN
COLUMN
10
|
45
|
name
DFHPPT TYPE=ENTRY,
PROGRAM=name,
PGMLANG=COBOL
description of entry
X
X
name
DFHPPT TYPE=ENTRY,
PROGRAM=name
description of entry
X
72
|
The first format is used for COBOL programs, as indicated by the PGMLANG
parameter. When this parameter is omitted, as in the second format, then the program
language for that PPT entry is assumed to be assembler language. This second entry
format is used for LX tables and maps. The field labeled “name,” on both formats, is
where the programmer specifies the name of the program, LX table or map. This name
must correspond to the member name of the module in the on-line CICS load library. To
the right of either entry format is a brief description of the entry. The “X” in column 72
is a continuation character and signifies that the line continues onto the next line. The
Chapter Eight - CICS Tables
149
Registry of Motor Vehicles – UMS Programmer’s Manual
following are examples of PPT entries for the program UGU1041P, the map UGU1040M
and the LX table UGU1040T, which are used for the UPH screen:
COLUMN
COLUMN
1
|
COLUMN
UGU1041P
DFHPPT TYPE=ENTRY,
UMS UPH GUEST INPUT
PROGRAM=UGU1041P,
PGMLANG=COBOL
X
X
UGU1040M
DFHPPT TYPE=ENTRY,
UMS UPH INQ SCREEN
PROGRAM=UGU1040M
X
UGU1040T
DFHPPT TYPE=ENTRY,
UMS UPH INQUIRY LXTABLE
PROGRAM=UGU1040T
X
10
|
COLUMN
45
|
72
|
When an SE wishes to add, change or delete PPT entries, the SE will need to create a
TSO member using a mask. The library that contains all the necessary information is
called RMVOL.JMV.TBLLIB. In this library, the member “HELP” contains instructions
on filling out a mask. The mask can then be filled out by using the member
“CICSMASK,” also in RMVOL.JMV.TBLLIB, and then saving the updated mask into
RMVOL.JMV.TBLLIB under a new name. The new member name should follow the
naming convention “PPTXXXXX” where PPT specifies the PPT table and “XXXXX” is
a set of characters the SE supplies to make the member name unique. To create a mask,
the SE fills out the requestor information fields in “CICSMASK,” appends his PPT
entries to the end of the member, and saves it under the new name. The requestor
information fields include name, phone number, an indication of whether this is an add,
delete or change, a list of the CICS regions to update, an indicator for necessary JCL
changes, and comments.
The mask member may be used to update entries in other CICS tables, such as the
Program Control Table (PCT) and the File Control Table (FCT). PPT entries are the only
entries discussed in this documentation section because they are the only ones that apply
for versioning.
When the updated mask member has been completed and saved into
RMVOL.JMV.TBLLIB, the SE should call the CICS Support Group in Boston to inform
them of the member name. CICS support will review the member and discuss what
needs to be done at that time. This will ensure that they understand what updates to
perform to which CICS regions and when the changes need to take place.
Chapter Eight - CICS Tables
150
Registry of Motor Vehicles – UMS Programmer’s Manual
For PPT entries that need to be updated in CV10, the programmer should make
arrangements for a CICS administrator to enter the updates on-line. The update mask
must be filled out for all the other regions.
Changes are applied to the test and production systems on a weekly basis. The cutoff
date/time for the test regions (T1, S1 and R1) is 3 P.M. on Monday. The updates will
become effective following test CICS maintenance at noon on Tuesday. The cutoff
date/time for the production regions (P1, A1 and M1) for MMS move only is Tuesday.
The updates will become effective following production CICS maintenance on
Wednesday.
After the updates have taken place, the SE should verify that the PPT updates were
successful. To verify successful completion of updates (adds) for UGU1040M and
UGU1040T, the SE would key in the following and then press enter:
CEMT IN PR(UGU1040*)
The “*” in the example is a wild card character that means any character is valid in that
position. If the add was successful, the following would be displayed:
PRO(UGU1040M) LEN(0000000) RECS(000) USE(000000) ASS ENA
PRO(UGU1040T) LEN(0000000) RECS(000) USE(000000) ASS ENA
The character string “ASS” signifies that the program language is assembler language
(“COB” would signify COBOL), and “ENA” says that it is enabled. The SE must verify
all updates. F3 terminates the “CEMT” transaction. In some regions, the SE may not
have security to execute the “CEMT” transaction. In these cases, he/she should call the
CICS Support Group in Boston and have them perform a PPT table lookup to verify the
updates.
When a new version of a UMS program, LX table, or map is placed in the PPTs, the SE
should have the old version name deleted from the PPTs. This should only be done when
the new version has been in production a sufficient amount of time and the old version is
no longer being executed. This way, the PPT tables will reflect current programs, LX
tables, and maps and will not fill up with obsolete entries.
UMS Setup Options UGZ0014P
The application portion of UMS requires a minimum of two TRANIDs to execute. These
are referred to as a session-startup TRANID and a default session-run TRANID. The
default values are UG03 and UG04 respectively. A site may elect to run with alternative
TRANID’s. To do this, two actions are required. First, PCT entries must be setup for the
desired TRANID’s. These should point to UGZ0001P, just as the release TRANID’s do.
Chapter Eight - CICS Tables
151
Registry of Motor Vehicles – UMS Programmer’s Manual
Secondly, the desired TRANID's need be specified in the SETUP macro within
UGZ0014P, and this module must be reassembled. The symbolic names are TRAN1 and
TRAN2. Thus, to make the session-startup TRANID be ZZZZ and the session-run
TRANID be AAAA, the following would be required:
.....,TRAN1=ZZZZ,TRAN2=AAAA...
Note that the value of TRAN1 must be 4 EBCDIC characters, but the value of TRAN2
may be 4 EBCDIC characters or 8 hexadecimal characters. This allows making the
default session-run TRANID a value which cannot be entered by a terminal operator very
easy. You should also note that UMS business functions normally all execute under the
default session-run TRANID. If, for some site dependent reason this is not satisfactory,
the site may specify alternative TRANID’s for some (or all) functions. This is
accomplished by generating the requisite PCT entries (identical to the default UG04
entry), and reassembling UGZ0002P after including the desired TRANID on the optional
TASK= parameter of each PCTEG you desire to change. The allowable values are 4
EBCDIC characters or 8 hexadecimal characters.
UMS contains a “hotkey” option, which allows the user to enter a second logical session,
for inquiry purposes (presumably related to some update function being attempted in the
primary session). The term “hotkey” refers to the key used to toggle between the
sessions. The default key used is PA1. The site may elect to use any of the three PA
keys for this purpose. This is specified in the SETUP macro with the HOTKEY
symbolic. The allowable values are PA1, PA2, or PA3. If you desired to use PA2, the
entry would be:
..............,HOTKEY=PA2
The use of the HOTKEY option by a user requires the UMS software to save the current
user environment so that it can be restored when the user returns to the primary logical
session. The environment is saved in CICS temporary storage, as two records on a queue
named UMSQ????, where ???? is the involved TERMID. The total length of the two
records is a minimum of 4096 bytes, and a maximum of approximately 6500 bytes,
depending largely on the amount of data currently being displayed in the primary session.
The queue is deleted on return from the secondary to the primary session. By default,
UMS will use TEMP STORAGE AUX. If the site desires, performance might be
enhanced by the use of TEMP STORAGE MAIN. This is specified in the SETUP macro
by specifying a value of MAIN for the symbolic TEMPSTOR:
..............,TEMPSTOR=MAIN
This option should ONLY be used if your CICS version is at least 1.7 and your MVS
version is at least XA.
Chapter Eight - CICS Tables
152
Registry of Motor Vehicles – UMS Programmer’s Manual
As discussed previously, UMS provides two internal mechanisms for preserving its
COMMAREA across pseudo-conversational interactions. One of these ways operates
outside of traditional CICS technique, the other uses traditional CICS techniques and a
VSAM cluster. Both of these techniques account for limitations inherent in older CICS
and MVS versions. UMS also supports a mechanism which allows a more conventional
CICS preservation of COMMAREA’s. This mechanism is only available if your CICS
version is at least 1.7 and your MVS version is at least XA. To use this option, you must
specify the value of the SYSTEM symbolic as XA and the value of the COMSAVE
symbolic as CICS:
......SYSTEM=XA,COMSAVE=CICS
You must still specify a device list in UGZ0014P, but the list need only contain 1 device
and the device does not have to exist. Note that by electing this option, you lose the
feature of being able to restrict the UMS access via the UGZ0014P device list. Also, as
compared with the UMS high-core save option, this technique has a higher degree of
system overhead.
Comparison of UMS COMMAREA save options:
MVS-SP
MVS-XA/ESA
CICS 1.6.1
1
2
CICS 1.7 or
better
1
3
1.
must use SYSTEM=SP (VSAM swap)
2.
may use SYSTEM=XA (highcore swap) or SYSTEM=SP (VSAM swap)
SYSTEM=XA is recommended
3.
may use SYSTEM=XA (highcore swap), SYSTEM=SP (VSAM swap) or
SYSTEM=XA,COMSAVE=CICS
SYSTEM=SP is not recommended
SYSTEM=XA,COMSAVE=CICS is recommended if you use autoinstall
with random id generation, or have a very large
terminal base with sparse use of UMS
SYSTEM=XA is recommended in all other cases
Chapter Eight - CICS Tables
153
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Eight - CICS Tables
154
Registry of Motor Vehicles – UMS Programmer’s Manual
GROUP NAME: PCTUMSGM
---------TRANSACTIONS:
CICS/VS
UGCL
UGCM
UGXX
UGYY
RDO OFF-LINE UTILITY PROGRAM
UGCY
UG01
UGLD
UG03
UGPR
UG04
UGSA
*****************************************************************
OBJECTS IN GROUPS UTILITY CO
*****************************************************************
GROUP NAME: PCTUMSGM
---------TRANSACTION(UGCL)
GROUP(PCTUMSGM) PROGRAM(UGZCLERP)
TWASIZE(0)
TRANSACTION(UGCM)
GROUP(PCTUMSGM) PROGRAM(UCOREMTR)
TWASIZE(0)
TRANSACTION(UGCY)
GROUP(PCTUMSGM) PROGRAM(UGZ0027P)
TWASIZE(0)
TRANSACTION(UGLD)
GROUP(PCTUMSGM) PROGRAM(UGZLOADP)
TWASIZE(0)
TRANSACTION(UGPR)
GROUP(PCTUMSGM) PROGRAM(UGZ0030P)
TWASIZE(0)
TRANSACTION(UGSA)
GROUP(PCTUMSGM) PROGRAM(USAMPLEP)
TWASIZE(0)
TRANSACTION(UGTH)
GROUP(PCTUMSGM) PROGRAM(UGZ0020P)
TWASIZE(0)
TRANSACTION(UGTL)
GROUP(PCTUMSGM) PROGRAM(UGZ0015P)
TWASIZE(0)
Chapter Eight - CICS Tables
155
Registry of Motor Vehicles – UMS Programmer’s Manual
TRANSACTION(UGTM)
GROUP(PCTUMSGM) PROGRAM(UGZ0990P)
TWASIZE(0)
TRANSACTION(UGXX)
GROUP(PCTUMSGM) PROGRAM(UGZXXXXP)
TWASIZE(0)
TRANSACTION(UGYY)
GROUP(PCTUMSGM) PROGRAM(UGZYYYYP)
TWASIZE(0)
TRANSACTION(UG01)
GROUP(PCTUMSGM) PROGRAM(UGT0001P)
TWASIZE(0)
TRANSACTION(UG03)
GROUP(PCTUMSGM) PROGRAM(UGZ0001P)
TWASIZE(0)
TRANSACTION(UG04)
GROUP(PCTUMSGM) PROGRAM(UGZ0001P)
TWASIZE(0)
GROUP NAME: PPTUMSGM
UGB0010M
UGB0010P
UGB0010T
UGB0011P
UGB0020M
UGB0020P
UGB0020T
UGB0021P
UGB0022P
UGB0030M
UGB0030P
UGB0030T
UGB0031$
UGB0031P
UGB0040M
UGB0040P
UGB0340P
UGB0340T
UGB0341P
UGB0410M
UGB0410P
UGB0410T
UGB0411P
UGB0420M
UGB0420P
UGB0420T
UGB0421P
UGB0430M
UGB0430P
UGB0430T
UGB0431P
UGB0500M
UGB3000P
UGB3000T
UGB3001P
UGB3020M
UGB3020P
UGB3020T
UGB3021P
UGB3040M
UGB3040P
UGB3040T
UGB3041P
UGB3060M
UGB3060P
UGB3060T
UGB3061P
UGC0010M
UGC1062P
UGETVOLS
UGI1320M
UGI1320T
UGI1321P
UGI1322P
UGI1340M
UGI1340T
UGI1341P
UGI1342P
UGI1350M
UGI1350T
UGI1351P
UGI1352P
UGL0010M
UGL0010P
UGL0220M
UGL0220P
UGL0220T
UGL0221P
UGL0240M
UGL0240P
UGL0240T
UGL0241P
UGL0260M
UGL0260P
UGL0260T
UGL0261P
UGL0262P
UGL0270M
UGL0270P
UGL0270T
UGL0330P
UGL0330T
UGL0331P
UGL0340M
UGL0340P
UGL0340T
UGL0341P
UGL0350M
UGL0350P
UGL0350T
UGL0351P
UGL0400M
UGL0400P
UGL0400T
UGL0401P
UGL0410M
Chapter Eight - CICS Tables
UGL0580P
UGL0580T
UGL0600M
UGL0600P
UGL0600T
UGL0601P
UGL0620M
UGL0620P
UGL0620T
UGL0621P
UGL0640M
UGL0640P
UGL0640T
UGL0641P
UGL0650M
UGL0650P
UGL1201P
UGL3200M
UGL3200P
UGL3200T
UGL3201P
UGL3206M
UGL3206P
UGL3206T
UGL3207P
UGL3300M
UGL3300P
UGL3300T
UGL3301P
UGL3320M
UGL3320P
UGL3320T
156
Registry of Motor Vehicles – UMS Programmer’s Manual
UGB0040T
UGB0041P
UGB0100P
UGB0210M
UGB0210P
UGB0210T
UGB0211P
UGB0212P
UGB0213P
UGB0310M
UGB0310P
UGB0310T
UGB0311P
UGB0320M
UGB0320P
UGB0320T
UGB0321P
UGB0330M
UGB0330P
UGB0330T
UGB0331P
UGB0340M
UGM0022P
UGM0022T
UGM0023P
UGM0024P
UGM0025P
UGM0026P
UGM0027P
UGM0028P
UGM0029P
UGB0500P
UGB0500T
UGB0501P
UGB0700M
UGB0700P
UGB0700T
UGB0701P
UGB0702K
UGB0702P
UGB0710M
UGB0710P
UGB0710T
UGB0711P
UGB0720M
UGB0720P
UGB0720T
UGB0721P
UGB0730M
UGB0730P
UGB0730T
UGB0731P
UGB3000M
UGM0062P
UGM0063P
UGM0064M
UGM0064P
UGM0066P
UGM0066T
UGM0067P
UGM0068P
UGM0068T
UGC0010T
UGC0011P
UGC0012P
UGC0610M
UGC0610T
UGC0611P
UGC0612P
UGC1030M
UGC1030T
UGC1031P
UGC1032P
UGC1040M
UGC1040T
UGC1041P
UGC1042P
UGC1050M
UGC1050T
UGC1051P
UGC1052P
UGC1060M
UGC1060T
UGC1061P
UGN0060M
UGN0060P
UGN0060T
UGN0061P
UGN0080M
UGN0080P
UGN0080T
UGN0081P
UGN0100M
UGL0011P
UGL0020M
UGL0020P
UGL0021P
UGL0030M
UGL0030P
UGL0031P
UGL0040M
UGL0040P
UGL0060M
UGL0060P
UGL0061P
UGL0062M
UGL0062P
UGL0070M
UGL0070P
UGL0071P
UGL0200M
UGL0200P
UGL0200T
UGL0201P
UGL0202P
UGN0280P
UGN0280T
UGN0300M
UGN0300P
UGN0300T
UGN0301P
UGN0320M
UGN0320P
UGN0320T
UGL0271P
UGL0280M
UGL0280P
UGL0280T
UGL0281P
UGL0290M
UGL0290P
UGL0290T
UGL0291P
UGL0292M
UGL0292P
UGL0292T
UGL0293P
UGL0310M
UGL0310P
UGL0310T
UGL0311P
UGL0320M
UGL0320P
UGL0320T
UGL0321P
UGL0330M
UGRO110P
UGRX100T
UGRX101T
UGRX102T
UGRX110T
UGR0010M
UGR0010P
UGR0011P
UGR0020M
UGL0410P
UGL0410T
UGL0411P
UGL0480M
UGL0480P
UGL0480T
UGL0481P
UGL0500M
UGL0500P
UGL0500T
UGL0510M
UGL0510P
UGL0510T
UGL0540M
UGL0540P
UGL0540T
UGL0541P
UGL0560M
UGL0560P
UGL0560T
UGL0561P
UGL0580M
UGR1092P
UGR110UM
UGR1140M
UGR1140T
UGR1141P
UGR1142P
UGR1170M
UGR1170T
UGR1171P
Chapter Eight - CICS Tables
UGL0650T
UGL0651P
UGL0700M
UGL0700P
UGL0700T
UGL0701P
UGL0870M
UGL0870P
UGL0870T
UGL0871P
UGL1000P
UGL1001P
UGL1007P
UGL1008P
UGL1009P
UGL1070M
UGL1070P
UGL1070T
UGL1071P
UGL1200M
UGL1200P
UGL1200T
UGR1250M
UGR1250T
UGR1251P
UGR1252P
UGR1260M
UGR1260T
UGR1261P
UGR1262P
UGR1270M
UGL3321P
UGL3430P
UGL3600P
UGM0001M
UGM0001P
UGM0001T
UGM0002P
UGM0010M
UGM0010P
UGM0010T
UGM0011P
UGM0012M
UGM0012P
UGM0012T
UGM0013P
UGM0020M
UGM0020P
UGM0020T
UGM0021M
UGM0021P
UGM0021T
UGM0022M
UGR2201P
UGR2202P
UGR2260M
UGR2260T
UGR2261P
UGR2262P
UGR2300M
UGR2300T
UGR2301P
157
Registry of Motor Vehicles – UMS Programmer’s Manual
UGM0030M
UGM0030P
UGM0030T
UGM0031P
UGM0032M
UGM0032P
UGM0032T
UGM0033P
UGM0040M
UGM0040P
UGM0040T
UGM0041P
UGM0050M
UGM0050P
UGM0050T
UGM0051P
UGM0052M
UGM0052P
UGM0052T
UGM0053P
UGM0055M
UGM0055P
UGM0055T
UGM0056P
UGM0060M
UGM0060P
UGM0060T
UGM0061P
UGM0062M
UGS1151P
UGS1152P
UGM0069P
UGM0070M
UGM0070P
UGM0070T
UGM0071P
UGM0080M
UGM0080P
UGM0080T
UGM0081P
UGM0090M
UGM0090P
UGM0090T
UGM0091M
UGM0091P
UGM0092M
UGM0092P
UGM0093M
UGM0094M
UGM0094P
UGM0094T
UGM0095P
UGN0020M
UGN0020P
UGN0020T
UGN0021P
UGN0040M
UGN0040P
UGN0040T
UGN0041P
UGUO120P
UGUO130P
UGN0120M
UGN0120P
UGN0120T
UGN0121P
UGN0140M
UGN0140P
UGN0140T
UGN0141P
UGN0160M
UGN0160P
UGN0160T
UGN0161P
UGN0180M
UGN0180P
UGN0180T
UGN0181P
UGN0200M
UGN0200P
UGN0200T
UGN0201P
UGN0220M
UGN0220P
UGN0220T
UGN0221P
UGN0240M
UGN0240P
UGN0240T
UGN0241P
UGN0280M
UGU1141P
UGU1142P
UGN0321P
UGN0322P
UGN0360M
UGN0360P
UGN0360T
UGN0361P
UGN0420M
UGN0420P
UGN0420T
UGN0421P
UGN0430M
UGN0430P
UGN0430T
UGN0431P
UGN0440M
UGN0440P
UGN0440T
UGN0441P
UGN0460M
UGN0460P
UGN0460T
UGN0461P
UGRI100P
UGRI101P
UGRI102P
UGRI110P
UGRO100P
UGRO101P
UGRO102P
UGU3041P
UGU3042P
UGR0020P
UGR0020T
UGR0021P
UGR0310M
UGR0310T
UGR0311P
UGR0312P
UGR0540P
UGR0541P
UGR0560P
UGR0561P
UGR100UM
UGR101UM
UGR102UM
UGR1060M
UGR1060T
UGR1061P
UGR1062P
UGR1070M
UGR1070P
UGR1070T
UGR1071P
UGR1080M
UGR1080T
UGR1081P
UGR1082P
UGR1090M
UGR1090T
UGR1091P
UGZLXCHK
UGZXXXXP
UGR1172P UGR1270T UGR2302P
UGR1180M UGR1271P UGR3060M
UGR1180T UGR1272P UGR3060T
UGR1181P UGR1280M UGR3061P
UGR1182P UGR1280T UGR3062P
UGR1190M UGR1281P UGR3260M
UGR1190T UGR1282P UGR3260T
UGR1191P UGR1310M UGR3261P
UGR1192P UGR1310T UGR3262P
UGR1200M UGR1311P UGR4060M
UGR1200T UGR1312P UGR4060T
UGR1201P UGR2060M UGR4061P
UGR1202P UGR2060T UGR4062P
UGR1210M UGR2061P UGR5060M
UGR1210T UGR2062P UGR5060T
UGR1211P UGR2140M UGR5061P
UGR1212P UGR2140T UGR5062P
UGR1220M UGR2141P UGS0100M
UGR1220T UGR2142P UGS0100P
UGR1221P UGR2180M UGS0101P
UGR1222P UGR2180T UGS1051M
UGR1230M UGR2181P UGS1051P
UGR1230T UGR2182P UGS1052P
UGR1231P UGR2190M UGS1100M
UGR1232P UGR2190T UGS1100T
UGR1240M UGR2191P UGS1101P
UGR1240T UGR2192P UGS1102P
UGR1241P UGR2200M UGS1150M
UGR1242P UGR2200T UGS1150T
UGZ0029X
UGZ0030#
Chapter Eight - CICS Tables
158
Registry of Motor Vehicles – UMS Programmer’s Manual
UGS1160M
UGS1160T
UGS1161P
UGS1162P
UGS1170M
UGS1170T
UGS1171P
UGS1172P
UGS1190M
UGS1190T
UGS1191P
UGS1192P
UGS1200M
UGS1200T
UGS1201P
UGS1202P
UGS2051M
UGS2051P
UGS2052P
UGS2150M
UGS2150T
UGS2151P
UGS2152P
UGS3051M
UGS3051P
UGS3052P
UGS3150M
UGS3150T
UGS3151P
UGS3152P
UGUI101P
UGUX101T
UGUX110T
UGUX120T
UGUX130T
UGU101UM
UGU1010M
UGU1010T
UGU1011P
UGU1012P
UGU1020M
UGU1020T
UGU1021P
UGU1022P
UGU1030M
UGU1030T
UGU1031P
UGU1032P
UGU1040M
UGU1040T
UGU1041P
UGU1042P
UGU110UM
UGU1110M
UGU1110T
UGU1111P
UGU1112P
UGU1120M
UGU1120T
UGU1121P
UGU1122P
UGU1130M
UGU120UM
UGU130UM
UGU2010M
UGU2010T
UGU2011P
UGU2012P
UGU2020M
UGU2020T
UGU2021P
UGU2022P
UGU2040M
UGU2040T
UGU2041P
UGU2042P
UGU2110M
UGU2110T
UGU2111P
UGU2112P
UGU2120M
UGU2120T
UGU2121P
UGU2122P
UGU2130M
UGU2130T
UGU2131P
UGU2132P
UGU3010M
UGU3010T
UGU3011P
UGU3012P
UGU3020M
UGU3110M
UGU3110T
UGU3111P
UGU3112P
UGU3120M
UGU3120T
UGU3121P
UGU3122P
UGU4020M
UGU4020T
UGU4021P
UGU4022P
UGVERIFY
UGV0010M
UGV0010P
UGV0010T
UGV0011P
UGV0030M
UGV0030P
UGV0030T
UGV0031P
UGW1110M
UGW1110T
UGW1111P
UGW1112P
UGW1130M
UGW1130T
UGW1131P
UGW1132P
UGW1140M
UGW1140T
UGZ0001P
UGZ0002P
UGZ0003P
UGZ0004P
UGZ0005P
UGZ0006#
UGZ0006M
UGZ0006P
UGZ0007P
UGZ0008P
UGZ0009P
UGZ0010P
UGZ0011P
UGZ0012P
UGZ0013P
UGZ0014M
UGZ0014P
UGZ0015M
UGZ0015P
UGZ0016P
UGZ0017P
UGZ0018P
UGZ0019P
UGZ0020$
UGZ0020P
UGZ0022P
UGZ0023P
UGZ0024$
UGZ0024P
UGZ0025#
UGZ0025@
UGZ0030P
UGZ0032M
UGZ0032P
UGZ0034P
UGZ0035P
UGZ0036P
UGZ0037P
UGZ0038P
UGZ0039P
UGZ0040P
UGZ0060P
UGZ1001P
UGZ1002P
UGZ9000P
Chapter Eight - CICS Tables
159
Registry of Motor Vehicles – UMS Programmer’s Manual
UGUI110P
UGUI120P
UGUI130P
UGUO101P
UGUO110P
UGU1130T
UGU1131P
UGU1132P
UGU1140M
UGU1140T
UGU3020T
UGU3021P
UGU3022P
UGU3040M
UGU3040T
UGW1141P
UGW1142P
UGZCLERP
UGZINITP
UGZLOADP
UGZ0025P
UGZ0026P
UGZ0028#
UGZ0028P
UGZ0029P
Chapter Eight - CICS Tables
160
Registry of Motor Vehicles – UMS Programmer’s Manual
9
UMS Screen Mapping
Procedures
Because the UMS System is CICS based, the use of Basic Mapping Support (BMS) is a
virtual necessity. Several components must be produced. First is the MAP itself, an object
module used at run time by CICS routines. Next is the storage definition of the data after
being processed by BMS (on input or output). In UMS, a third DSECT, or storage
definition is needed, the one for the programs working storage or communication area.
There are some options on creating the first two items that will be mentioned here, but the
third DSECT must be created by hand.
In this third definition, the data field must be UMS-compatible with the screen map
definition; that is of the same type and length or of one that matches one of the LXTABLE’s
automatic conversions such as PIC 9(5) into S9(4) comp. Each one of these fields must be
preceded by two one-byte fields suffixed by “_Z” and “_T” respectively. These Z and T
fields have functions in the LXTABLE processing cycle that are discussed in that chapter.
If you do not plan to use the Z and T fields, that can be replaced by two filler bytes as PIC
XX or DS CL2. For example, if you were operating with the field “DRIVER-NAME,” the
DSECT fields might look as follows:
05 DRIVER-NAME-G.
10 DRIVER-NAME-Z
10 DRIVER-NAME-T
10 DRIVER-NAME
PIC X.
PIC X.
PIC X(25).
These T and Z field names are conveniently generated by the GFLD macro for assembler
programs and the LX table assembly. The call <fldname> GFLD <asmpic> is the pattern.
For example:
DRVRNM GFLD CL25
DRVRNM_Z DS
DRVRNM_T DS
DRVRNM
DS
will produce
CL1
CL1
CL25
The field DRVRNM is the one that will be mentioned in the LXTABLE entries. The
LXTABLE processing assumes that the other two fields are represented. If they are not, the
mapping results will be unpredictable.
The options come in the creation of the map itself and its DSECT. System development has
access to the EDS Screen Generator program which, for licensing reasons, is not placed on
the distribution tape. The generator is described later in this chapter.
Chapter Nine - UMS Screen Mapping Procedures
161
Registry of Motor Vehicles – UMS Programmer’s Manual
The manual map generation process has been somewhat simplified. In place of coding the
DFHMSD and DFHMDI macros, code the required UMSHEADER macro. This macro
generates the DFHMSD and DFHMDI invocations along with a standard heading for all
UMS screens. Parameters on the macro provide the necessary customization as follows:
<name> UMSHEADR <sfunc>,<scrntitle>,TYPE=<type>,SYSTEM=<sys>
<name> is a required 1 to 6 character map name for
the assembly
<sfunc> is a required positional parameter, a 1 to
4 character function code, served by this
screen, that appears in the screen header
<scrntitle> is a required positional parameter, a
1 to 80 character literal that will be a
title appearing on the second line of the
screen
<type> = NORMAL | DSECT
the assembler output
form, Normal generates map statements, Dsect
generates the DS definitions
<sys> = UMS | ALAR
date format:
mm/dd/yy
this determines the screen
UMS = mm/dd/yyyy, ALAR =
This macro generates 4 UMS-standard fields:
♦ The current date
♦ The time
♦ The function (from <sfunc>)
♦ A 50-character message line
These are all manipulated outside of the application program. To write messages, one only
specifies a message number (see chapter on Error Messages) and the proper text is inserted
by the system control programs.
Following this macro, code the standard DFHMDF macros to define each map field and
literal for the screen. The standard requires the names of the fields be of the form:
FLD<fnum>
where <fnum> is a 3 or 4 digit number,
beginning with 5 that is zero filled, such
as:
FLD005, FLD0007, FLD012
Chapter Nine - UMS Screen Mapping Procedures
162
Registry of Motor Vehicles – UMS Programmer’s Manual
They begin with 5 as the UMSHEADR generates the first 4 fields in the map. After the
last macro, one must supply the standard (CICS) DFHMSD TYPE=FINAL and an
assembler END statement. When all these statements are assembled and linked, the map
module is complete. The only problem with this process is the names of the fields. The
mapping macros are assembler orientated and the names must be 7 characters or less,
with the macro expansion supplying the eighth. Even though the newer assembler
supports 30-character data names, the UMSHEADR macro does not currently support a
language parameter and defaults to “LANG=ASM” in the DFHMSD macro. This forces
one to hard code the COBOL storage definition. There are only two “tricks” to this.
♦ First, provide 12 bytes of filler at the head of the map storage.
♦ Second, provide three (3) bytes of storage ahead of each data field.
Using LXTABLE, one does not reference these fields so a definition of “PIC X(3).” is
sufficient. Properly, they are first, “PIC S9(4) COMP.” followed by “PIC X.” This
non-automatic description generation works well but one must be very careful that screen
map changes affecting the length, type, or location of fields be reflected in two additional
places, the hand-coded map “DSECT” and the storage definition for the application
program which is accompanied by the “Z-field,” “T-field” components. The EDS map
generator has the advantage of generating the map source (which must be modified) and
its COBOL storage definition in the same pass. This will eliminate one source of
potential errors. Remember, map/dsect misalignments produce “unpredictable” results.
At the end of this chapter is the various “code” segments for a very simple map to
illustrate the components required. The Map Generator discussion can be read to see
these components from another perspective.
Map Generator Description
Basic Mapping Support (BMS) is used to define screens that interactive CICS on-line
programs will display. Defining a screen means specifying all the fields on the screen
and their attributes. The batch Map Generator program uses the screen definition
(picture) to create a map macro and COBOL copy member of the screen variables.
In this description, the term “picture” is used to signify the TSO member that contains the
necessary elements to define a screen (map). The first step in creating a map is to create
the picture. Pictures of each UMS screen are stored by screen name in
RMVMV.JMV.ISPPLIB. The UMS screen pictures also reside in
RMVMV.RMV.UMSSRCEP and should be maintained in both libraries. If an SE
creates a new UMS screen or modifies an existing one, he needs to promote the screen’s
final picture to both libraries. If the picture for an existing screen is more current in one
of the libraries than the other, the SE should use the more current one and put the final
picture in both libraries. When the SE is creating a new UMS screen, he should use an
Chapter Nine - UMS Screen Mapping Procedures
163
Registry of Motor Vehicles – UMS Programmer’s Manual
existing picture as a base to avoid having to key in all the parts of the picture member that
are the same for all pictures.
At the top of the picture is the “control” section that includes the DFHMSD macro that is
used to define the mapset. A mapset may contain one or more maps but the standard
convention is one map per mapset. The DFHMSD macro specifies the mapset name
(same as the map name) along with parameters that define the mapset. These parameters
should never need to be changed.
Following the “control” section is the “screen” section. This section contains a
representation of the screen which indicates exactly how the screen is to appear in the
CICS region. The screen’s title is typed in along with all headers and field names. The
length of each variable field is represented by the number of underline (“_”) marks. Five
underline marks signify that the field may contain up to five characters. The Map
Generator requires that variable fields be separated either by one space or by three or
more spaces. The requirement exists so that each variable field may be preceded by its
attribute byte and followed by a stopper byte. If only two spaces are provided between
two variable fields, the Map Generator job will give a return code of four when executed.
If one space is provided, it acts as both the stopper and the attribute byte.
Following the “screen” section is the “fields” section, which contains variable fields
information (attributes) for the screen. This section is made up of columns, with headers
specifying the various attributes. There is one screen field specified per row. To specify
the attributes for a screen field, indicators are placed in the corresponding attribute
columns. The screen fields are specified in the order that they appear on the screen (from
left-to-right and top-to-bottom). The only field information required is the field name
and its attributes. Below is a list of the most commonly specified attributes, the column
header for each attribute, and the valid values that may be specified in each column:
-
PROT column: indicates whether or not the operator may key data into the
field. The field may be protected, unprotected or auto-skip, and these are
specified by “P,” “U,” or “A” respectively.
-
NUM column: indicates if the field is to contain numeric data only. This
is specified by an “N” and is applicable only for terminals that have
numeric lock capability.
-
DSPLY column: indicates the field’s display intensity. This intensity may
be normal, bright or dark (not displayed) and is specified by “N,” “B,” or
“D” respectively.
-
FSET column: indicates the field will always be treated as if the operator
keyed data into it, whether he did or not. To indicate this, an “F” is
specified in this column.
Chapter Nine - UMS Screen Mapping Procedures
164
Registry of Motor Vehicles – UMS Programmer’s Manual
-
CURSR column: indicates that the cursor will be placed at the beginning
of this field when the screen is displayed. To indicate this, an “I” is
specified in this column.
-
JUSTFY column: indicates how data is to be justified in the field. Field
justification can be left-justify/zero fill, left-justify/blank fill, right
justify/zero fill and right-justify/blank fill. These justifications are
indicated by “LZ,” “LB,” “RZ,” and “RB” respectively.
The map picture is completed once all the screen fields have been defined by indicating
their names and attributes. After the picture has been created, the Map Generator job
may be run to create the map macro and copy member.
The Map Generator JCL is located in RMVMV.JMV.USRJCL(T10JMAPG). It is to be
used in conjunction with RMVMV.JMV.USRJCL(T10JMAPA), which is discussed
below. The Map Generator will create a map macro and a COBOL copy member. These
two created members will be named and placed in the libraries according to the SE’s
specifications. To execute the Map Generator job, all the SE needs to do is retrieve
T10JMAPG, change the picture name, change the DSLIB and BMSLIB library
destinations and member names, and submit the job. A good EOJ is when all three proc
steps have a return code of zero.
Once the map macro has been generated, the SE must make some changes to it so that it
may then be assembled in the UMS environment. The map macro contains all the fields
specified on the screen. The first four fields (Date, Time, Function, and MSG) on all
UMS screens have their own map macro. This map macro is called “UMSHEADR” and
resides in “RMVMV.RMV.UMSMACRO.” To make the changes to the new map
macro, the SE needs to retrieve it and delete everything up to and including the definition
of field four (which Map Generator has named “FLD0004”). Once this is completed,
RMVMV.RMV.USRJCL(T10JMAPA) comes into play. This member contains
instructions in a flower box and the JCL necessary to assemble maps (which will bring in
the “UMSHEADR” member thus replacing all the code that was deleted). The SE will
copy T10JMAPA into the top of his map macro (where the deleted code used to be).
Once this is done, the SE needs to follow the instructions in the flower box. These
instructions include changing the applicable map names and title, that were in
T10JMAPA, to the correct names/title and then deleting the flower box. Once this is
completed, the map macro member may be saved as the final version of the macro that
will be moved to the production source libraries. This map macro member now contains
the JCL necessary to assemble the map and can then be “subbed” to assemble it. A
successful map assemble is indicated when the assemble and link-edit steps have return
codes of zero.
Special notes:
Chapter Nine - UMS Screen Mapping Procedures
165
Registry of Motor Vehicles – UMS Programmer’s Manual
The UPIC screen, which is used to attach vehicles to a policy, cannot use Map Generator.
On this screen are three columns of vehicle information that contain data such as the
vehicle’s VIN and registration (one column for each vehicle). The programs that perform
the processing for the UPIC screen, require that the flow be left-to-right/top-to-bottom
within each column. Map Generator takes a picture and creates a map macro with left-toright/top-to-bottom for the whole screen and not for special columns. When the screen
was created, the map macro fields were moved around so that the flow would be correct.
If an SE needs to make a change to this screen, he/she will need to change both the
picture and the map macro.
A word of caution: an SE may have made a change directly to a screen’s map macro and
never updated the picture; therefore the picture may not reflect the current screen. The
map macro is always current since its object code is what is executed. If an SE discovers
this situation has occurred, he/she needs to update the picture with the previous changes
along with his/her changes so it will be in sync for the next SE.
A final note is that an SE may have added some comments in the form of a flower box to
the top of a map macro (between the JOB card and the EXEC card). This may contain
information such as CSR number/date and the SE’s name. When the next SE makes
changes to this screen, he/she needs to perform all the steps listed previously and copy
this flower box into the updated map macro. By doing this, the flower box will not be
lost when one moves the updated map macro to production.
Map Generator Example
The following picture is an example of a simple map (MAPTEST) that would be stored
in RMVMV.JMV.ISPPLIB. In this example, the row/columns for the screen fields may
not match exactly between the picture and the map macro as this is a representation only.
Additionally, the percent (%) sign is being used to represent the cent sign.
COL 80
|
%CONTROL MAPTEST
MAPTEST DFHMSD TYPE=DSECT,
CTRL=(FREEKB,FRSET),
LANG=ASM,
X
MODE=INOUT,
TERM=3270-2,
TIOAPFX=YES,
STORAGE=AUTO
%SCREEN MAPTEST
__________ _____
MASS REGISTRY OF MOTOR VEHICLES
MAPTEST
THIS IS A MAP TEST SCREEN
FUNCTION: ____ MSG: ____________________________________ PG __
LIC #: _________________________
ST: __
%FIELDS MAPTEST
VARIABLE FIELDS INFORMATION
|----------------+-+--+----+---+---+---+-+-+-+-+-+-+-+-+-+-+-+-+
|
| | |
|
|
|ATTRIBUTE | |J |H|V| |
|
| |L |
|
|
| | |D| | |C|C |U |I|A| |
Chapter Nine - UMS Screen Mapping Procedures
X
X
X
X
X
166
Registry of Motor Vehicles – UMS Programmer’s Manual
|
|F|E |
|
|
|P| |S|F| |U|O |S |L|L| |
|
|L|V | # |
| LOCN |R|N|P|S|P|R|L |T |I|I| |
|
|A|E |OCCU|
| ---- |O|U|L|E|E|S|O |F |T|D|P|
| FIELD NAME
|G|L |RS |LEN|ROW|COL|T|M|Y|T|N|R|R |Y |E|N|S|
|----------------+-+--+----+---+---+---+-+-+-+-+-+-+-+-+-+-+-+-+
MAPTEST-DATE
| | |
|
|
|
|A| |N| | | | |RB| | | |
MAPTEST-PASSWORD | | |
|
|
|
|U|N|D| | | | |RZ| | | |
MAPTEST-FUNCTION | | |
|
|
|
|U| |N| | | | |LB| | | |
MAPTEST-MSG
| | |
|
|
|
|P| |B| | | | |LB| | | |
MAPTEST-PAGE
| | |
|
|
|
|P|N|N| | | | |LB| | | |
MAPTEST-LIC-NBR | | |
|
|
|
|U|N|B|F| |I| |LZ| | | |
MAPTEST-LIC-ST
| | |
|
|
|
|U| |B|F| | | |LB| | | |
%END
When the Map Generator job, RMVMV.JMV.USRJCL(T10JMAPG), runs, it takes the
completed picture and creates a COBOL copy member and a BMS map macro. The created
copy member would begin as follows:
01
MAPTEST.
05 FILLER
05 MAPTEST-DATE-G.
10 MAPTEST-DATE-L
10 MAPTEST-DATE-A
10 MAPTEST-DATE
05 MAPTEST-PASSWORD-G.
10 MAPTEST-PASSWORD-L
10 MAPTEST-PASSWORD-A
10 MAPTEST-PASSWORD
PIC X(12).
PIC S9(4) COMP.
PIC X.
PIC X(10).
PIC S9(4) COMP.
PIC X.
PIC 9(05).
The rest of the screen’s fields in this copy member would be defined in much the same
way. Each field has a group name and is broken down into three elementary data items:
first is the length for the field, second is the attribute byte for the field, and third is the
actual field. The password was given a NUMERIC attribute in the picture and thus
received a “PIC 9” definition in the copy member.
The BMS map macro created by Map Generator would appear as follows (some of the
macro code is omitted here in the interest of brevity):
COL 72
|
MAPTEST
X
DFHMSD
TYPE=DSECT,
CTRL=(FREEKB,FRSET),
X
LANG=ASM,
MODE=INOUT,
STORAGE=AUTO,
TERM=3270-2,
X
X
X
X
X
Chapter Nine - UMS Screen Mapping Procedures
167
Registry of Motor Vehicles – UMS Programmer’s Manual
TIOAPFX=YES
MAPTEST
X
FLD0001
DFHMDI
SIZE=(24,80)
DFHMDF POS=(001,002),LENGTH=0010,
JUSTIFY=(RIGHT,BLANK),
ATTRB=(ASKIP)
X
X
(FLD0002 through FLD0003 are omitted)
FLD0004
DFHMDF POS=(003,022),LENGTH=0050,
JUSTIFY=(LEFT,BLANK),
ATTRB=(PROT,BRT)
Chapter Nine - UMS Screen Mapping Procedures
X
X
168
Registry of Motor Vehicles – UMS Programmer’s Manual
COL 72
|
FLD0005
DFHMDF POS=(003,073),LENGTH=0002,
INITIAL='PG'
X
DFHMDF POS=(003,076),LENGTH=0002,
JUSTIFY=(LEFT,BLANK),
ATTRB=(PROT,NUM)
X
X
(FLD0006 through FLD0007 are omitted)
DFHMSD TYPE=FINAL
END
To complete the map macro, the programmer deletes all code from the top of the map
macro through FLD0004 and copies RMVMV.JMV.USRJCL(T10JMAPA) in its place.
Once this is completed, the contents of T10JMAPA are modified to reflect this map’s
name/title. Following is the completed BMS map macro member:
//T10JMAPA JOB (5CGWBX,A51B),'MAPTEST',
//
CLASS=S,MSGCLASS=V,NOTIFY=T07JSEB
//STEP010 EXEC CACASMM,UMEM=MAPTEST
//ASM.SYSIN DD *
TITLE 'MAPTEST -- THIS IS A MAP TEST SCREEN'
MAPTEST UMSHEADR MAPT,'THIS IS A MAP TEST SCREEN'
DFHMDF POS=(003,073),LENGTH=0002,
INITIAL='PG'
FLD0005 DFHMDF POS=(003,076),LENGTH=0002,
JUSTIFY=(LEFT,BLANK),
ATTRB=(PROT,NUM)
+
+
+
+
++++++
X
X
X
(FLD0006 through FLD0007 are omitted)
DFHMSD TYPE=FINAL
END
The contents of T10JMAPA are indicated by the “+” bracket. In the sixth line of the map
macro above, the value “MAPT” is the screen's function code.
When the programmer submits this job, the macro will be assembled and will create the
object code that is used for displaying the screen.
Chapter Nine - UMS Screen Mapping Procedures
169
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Nine - UMS Screen Mapping Procedures
170
Registry of Motor Vehicles – UMS Programmer’s Manual
10
UMS Online Error Messages
The error-code passed with the outbound message text is structured as a 4 byte field,
which is treated as a 1 word binary number. From the application perspective, it needs to
be considered as a signed 9 digit numeric field.
Digits
0-1
2-5
6-8
Length Usage
2 major process identification
2
field grouping code - characters 4 through 7 of originatory program.
i.e., for UGB0710P, these four characters would be ‘0710.’
3 sequence number
The concept is that a given code will be issued by one module under 1 set of conditions,
only. The first 3 digits will relate to the module. The field grouping code will, within the
module, attempt to localize the field(s) being processed when the error was detected. The
detail code will attempt to further qualify the problem. These sub-field usages are
designed to make analysis simpler on all sides. However, the general concept will be that
a unique 9 digit code yields a unique message (from the message dictionary on the guest
side). The only time the guest will be concerned with the sub-code breakdown is if its
dictionary is out of sync and the text cannot be located.
The dictionary will contain a flag set for each message which indicate if the 8 byte error
qualifier field is used for this code, and if so how. This structure is not defined at this
time.
Note: If the same error-text is produced from more than 1 place, it is assigned multiple
codes so that the source can be localized as required.
The Host Function/Dispatch/Security process reserves all Error Codes with digits 0-2 in
the range of 100-199 for itself. Guest processes need to be aware of this value range.
UMS online programs move error numbers to the common area when an error is
encountered. The Guest Side Cleanup module (UGZ0005P) matches the error number
with an error number in the error message table and finds a corresponding error message.
Error messages reside in a member named UGZ0004P in the UMS source libraries.
Chapter Ten - UMS Online Error Messages
171
Registry of Motor Vehicles – UMS Programmer’s Manual
**** This member consists of list the following messages:
Type of messages
Range of numbers
Copybook
UMS control CICS programs messages
199-200
UMS error messages
201-299
EDS messages
300-599
$EDSMSGS
MRB messages
600-699
$MRBMSGS
Stopper/enabler messages
800-899
Alars error messages and NDR responses
900-999
The EDS and MRB message copy members reside in the UMS macro libraries.
******
To change a message in $EDSMSGS or $MRBMSGS, the SE should copy
the error message member from RMVM.RMV.UMSMACR3 library to
RMVMV.RMV.UMSMACRO library, make the needed changes, copy the error message
table UGZ0004P from RMVM.RMV.UMSSRCE3 to RMVMV.RMV.UMSSRCE,
reassemble this table with new changes, move modified copybook and error message
table (UGZ0004P) to CV14 and CV11 library using automated UMS move method.
To change a message (UMS, Alars , or Stopper/enabler message), the programmer should
copy the error table UGZ0004P from RMVMV.RMV.UMSSRCE library to
RMVMV.RMV.UMSSRCE, make the needed changes, reassemble the error table, move
modified UGZ0004P (error message table) to CV14 and CV11 library using automated
UMS move method.
Chapter Ten - UMS Online Error Messages
172
Registry of Motor Vehicles – UMS Programmer’s Manual
Adding an Error Message to a Program
The members $EDSMSGS, $MRBMSGS, and UGZ0004P (error message table) are
arranged by error number and program name. To add an error number, the programmer
should find the sequence of numbers that exists for the program, and choose the next
available number. If an error message is being added that already exists for a different
program, then an alias is used as a pointer to the previous message. An alias can only be
used if the new error number is greater than the alias number.
The programmer should copy $EDSMSGS or $MRBMSGS to RMVMV.RMV.MACRO
(test library). If EDS message or MRB message must be added, then copy the error
message table UGZ0004P from RMVMV.RMV.MACR3 to RMVM.RMV.MACRO, add
new message and reassemble the error table.
Example:
The program UGRO011P needs an error message for "F8 INVALID, IMPROPER
CURSOR POSITIONING". Following is a sample of the member $EDSMSGS:
ERR
ERR
ERR
203001010,UGRO010P,,'F8 INVALID, IMPROPER CURSOR
POSITIONING'
203001011,UGRO010P,,'F8 INVALID, END OF SET ENCOUNTERED'
204001010,UGRO011P,,'ALIAS=200001011'
In this case, the new entry would appear as follows:
ERR
20400101011,UGRO011P,,'ALIAS=203001010'
In this example the ALIAS points to the error message used for error 203001010.
UGZ0004P - The Message Module
UGZ0004P is a module also known as the message text module. This module is the
central repository for all UMS system messages. The system programs use a message
code passed in the commarea to the clean-up control module (UGZ0005P) which will
translate the code into the text which is then put into the appropriate area on the screen.
Chapter Ten - UMS Online Error Messages
173
Registry of Motor Vehicles – UMS Programmer’s Manual
Messages must be in ascending order by error-code.
ERROR DICTIONARY ELEMENT DEFINITION
&P0
ERR &P1,&P2,&P3,&P4
&P1 = Required 9 decimal digit error-code
&P2 = Required 1 to 8 Byte Program-name
&P3 = Optional 1 to 8 hex digit flagset
&P4 = Required 1 to 50 byte message
NOTE: The message can be replaced by text of the form of 'ALIAS=123456789'
where 123456789 is the code number of a previously defined message to
reuse the same text with a different error number.
Some Examples:
ERR
ERR
ERR
ERR
203001011,UGR0010P,,'F8 INVALID. END OF SET
ENCOUNTERED.'
203001012,UGR0011P,,'ALIAS=200001011'
203001013,UGR0011P,,'ALIAS=200001011'
203001014,UGR0011P,,'ALIAS=201001013'
Chapter Ten - UMS Online Error Messages
174
Registry of Motor Vehicles – UMS Programmer’s Manual
Assembled Example of a Message Module
Note: These examples have been slightly modified by text-edit to allow them to fit in the
page or to improve their readability. For brevity, some macros have a number of
parameters to show the results of expansion. Some combinations, while assembled
correctly may be illogical. Please consult the detailed write-up for parameter usage.
SYMBOL
CSECT1
CSECT2
LOC
000000
TYPE
ID
EXTERNAL SYMBOL DICTIONARY
ADDR LENGTH LD ID FLAGS
SD 0001 000000 000064
SD 0002 000068 00006B
PAGE
1
ASM H V 02 14.58 07/10/91
00
00
ECE0004P - TEST GUEST-SIDE ERROR MESSAGE DICTIONARY
OBJECT CODE
ADDR1 ADDR2 STMT
SOURCE STATEMENT
2
3
136
137
138
139
140
141
142
143
144
145
&OPTPR
.TP010
.TP020
CSECT1
PUSH
PRINT
POP
GBLC
SETC
AIF
AIF
AIF
ANOP
PRINT
ANOP
START
PAGE
2
ASM H V 02 14.58 07/10/91
PRINT
OFF
PRINT
&OPTPR
'&SYSPARM'
('&OPTPR' EQ 'GEN').TP020
('&OPTPR' EQ '').TP020
('&OPTPR' EQ 'NOGEN').TP010
GEN
0
Chapter Ten - UMS Online Error Messages
175
00110000
00120000
01450000
01460000
01470000
01480000
01490000
01500000
01520000
01530012
01540000
01550000
Registry of Motor Vehicles – UMS Programmer’s Manual
000000
000004
000008
00000C
146
147
148
149
150
151
*
S T A R T
O F
T A B L E
P R E F I X
NUMENT
DC
F'0'
DC
A(FIRSTTAG)
FIRSTDTL DC
A(CSECT2)
DC
A(RELEASE)
RELEASE DC
AL2(030),CL9'&SYSDATE'
DC
CL5'&SYSTIME',C'=VER 03.01='
+RELEASE DC
AL2(030),CL9'07/10/91'
+
DC
CL5'14.58',C'=VER 03.01='
152 FIRSTTAG DS
0F
153 *
E N D
O F
T A B L E
P R E F I X
00000000
0000002C
00000068
00000010
000010 001EF0F761F1F061
00002C
00002C
00002C 05F5E101
000030 14000000
000068
00068
000068 C8D6E2E340D4D6C4
000034
000034
000034 05F5E102
000038 14000015
00007D
0007D
00007D E4D5D2D5D6E6D540
00003C
01560000
01570000
01580000
01590000
01600000
01610000
01610000
01620000
01630000
154
ERR
100000001,UHZ0001P,,'HOST MODULE NOT FOUND'
155+CSECT1
CSECT
01-00125
156+D100000001 DC F'100000001'
+
DC AL1(L'TG30001-1+X'0'),AL3(TG20001-CSECT2)
157+CSECT2
CSECT
01-00127
158+TG20001
EQU *
01-00128
159+TG30001
DC C'HOST MODULE NOT FOUND'
01-00132
160+CSECT1
CSECT
01-00133
161
ERR
100000002,UHZ0022P,,'UNKNOWN HOST FUNCTION'
162+CSECT1
CSECT
01-00125
163+D100000002 DC F'100000002'
+
DC AL1(L'TG30002-1+X'0'),AL3(TG20002-CSECT2)
164+CSECT2
CSECT
01-00127
165+TG20002
EQU *
01-00128
166+TG30002
DC C'UNKNOWN HOST FUNCTION'
01-00132
167+CSECT1
CSECT
01-00133
Chapter Ten - UMS Online Error Messages
176
Registry of Motor Vehicles – UMS Programmer’s Manual
00003C
00003C 05F5E103
000040 1500002A
000092
00092
000092 D9C5C3E4D9E2C9E5
000044
168
ERR
100000003,UHZ0333P,,'RECURSIVE DUP-KEY CALL'
169+CSECT1
CSECT
01-00125
170+D100000003 DC F'100000003'
+
DC AL1(L'TG30003-1+X'0'),AL3(TG20003-CSECT2)
171+CSECT2
CSECT
01-00127
172+TG20003
EQU *
01-00128
173+TG30003
DC C'RECURSIVE DUP-KEY CALL'
01-00132
174+CSECT1
CSECT
01-00133
0000A8 C4E4D760D2C5E840
00004C
175
ERR
456789004,UHZ0001P,,'DUP-KEY NOT SPECIFIED'
176+CSECT1
CSECT
01-00125
177+D456789004 DC F'456789004'
+
DC AL1(L'TG30004-1+X'0'),AL3(TG20004-CSECT2)
178+CSECT2
CSECT
01-00127
179+TG20004
EQU *
01-00128
180+TG30004
DC C'DUP-KEY NOT SPECIFIED'
01-00132
181+CSECT1
CSECT
01-00133
00004C
00004C 21D954B3
000050 FF00003C
182
ERR
567891123,UHZ0001P,,'ALIAS=100000003'
183+CSECT1
CSECT
184+A567891123 DC F'567891123'
+
DC XL1'FF',AL3(D100000003-CSECT1)
000054
000054 2E4BD352
000058 FF000044
185
ERR
776721234,UHZ0003P,12345678,'ALIAS=456789004'
186+CSECT1
CSECT
01-00118
187+A776721234 DC F'776721234'
+
DC XL1'FF',AL3(D456789004-CSECT1)
01-00119
00005C
188
ERR
189+CSECT1
000044
000044 1B3A0C0C
000048 14000040
0000A8
000A8
01680012
01-00118
01-00119
880000102,UHZ0003P,FFEE1234,'INVALID MVE LENGTH'
CSECT
01-00125
Chapter Ten - UMS Online Error Messages
177
Registry of Motor Vehicles – UMS Programmer’s Manual
00005C 3473BC66
000060 95000055
0000BD
000BD
0000BD FFEE1234
0000C1 C9D5E5C1D3C9C440
000064
000064
00064
00000
000064
000000 00000007
000004
00064
IEV254
*** MNOTE ***
IEV254
*** MNOTE ***
190+D880000102 DC F'880000102'
+
DC AL1(L'TG3000 -1+X'84'),AL3(TG20007-CSECT2)
191+CSECT2
CSECT
01-00127
192+TG20007
EQU *
01-00128
193+
DC
XL4'FFEE1234'
01-00130
194+TG30007
DC C'INVALID MVE LENGTH'
01-00132
195+CSECT1
CSECT
01-00133
197 CSECT1
CSECT
04509200
198 LASTTAG EQU
*
04509300
199
ORG
NUMENT
04509400
200
DC
A((LASTTAG-FIRSTTAG)/8)
04509500
201
ORG
04509600
202
GBLC &WARN,&WTEMP
04509700
203
GBLA &MSGDUP,&ALIDUP
04509800
204 &WTEMP
SETC '&MSGDUP'
04509900
205
MNOTE &WARN,'&WTEMP AUTOMATIC ALIAS ENTRIES GENERATED'
+
,0 AUTOMATIC ALIAS ENTRIES GENERATED
04510000
206 &WTEMP
SETC '&ALIDUP'
04520000
207
MNOTE &WARN,'&WTEMP INVALID ALAS REFERENCES CHANGED'
+
,0 INVALID ALIAS REFERENCES CHANGED
04530000
208
END
04540000
MVS/XA DFP VER 2 LINKAGE EDITOR
14:58:28
JOB RMCJEBBP
STEP STEP010
PROCEDURE LKED
INVOCATION PARAMETERS - LIST,XREF
ACTUAL SIZE=(317440,79872)
OUTPUT DATA SET RMVMV.UMS.RMCJEBB IS ON VOLUME RELP02
WED
JUL 10, 1991
CROSS REFERENCE TABLE
CONTROL SECTION
NAME
ORIGIN
NAME
LOCATION
LENGTH
ENTRY
NAME
LOCATION
NAME
Chapter Ten - UMS Online Error Messages
LOCATION
NAME
178
LOCATION
Registry of Motor Vehicles – UMS Programmer’s Manual
CSECT1
CSECT2
00
68
64
6B
LOCATION REFERS TO SYMBOL
SECTION
8
CSECT2
ENTRY ADDRESS
00
IN CONTROL SECTION
LOCATION
REFERS TO SYMBOL
CSECT2
TOTAL LENGTH
D8
** ECE0004P REPLACED AND HAS AMODE 24
** LOAD MODULE HAS RMODE 24
** AUTHORIZATION CODE IS
0.
Chapter Ten - UMS Online Error Messages
179
IN CONTROL
Registry of Motor Vehicles – UMS Programmer’s Manual
Hexidecimal dump of Message Module Example
AMASPZAP INSPECTS, MODIFIES, AND DUMPS CSECTS OR SPECIFIC DATA RECORDS ON DIRECT ACCESS STORAGE.
DUMPT ECE0004P ALL
00110006
**CCHHR- 0011000336
RECORD LENGTH- 0000D8
000000
00000007 0000002C 00000068 00000010
000020
7EE5C5D9 40F0F34B F0F17E00 05F5E101
000040
1500002A 1B3A0C0C 14000040 21D954B3
000060
95000055
**CCHHR- 0011000336
RECORD LENGTH- 0000D8
000000
C8D6E2E3 40D4D6C4 E4D3C540 D5D6E340
000020
E340C6E4 D5C3E3C9 D6D5D9C5 C3E4D9E2
000040
C4E4D760 D2C5E840 D5D6E340 E2D7C5C3
000060
40D4E5C5 40D3C5D5 C7E3C8
MEMBER NAME ECE0004P CSECT NAME CSECT1
001EF0F7 61F1F061 F9F140F1 F44BF5F8 *................*
*..07/10/91 14.58*
14000000 05F5E102 14000015 05F5E103 *=VER 03.01=..5..*
*.....5.......5..*
FF00003C 2E4BD352 FF000044 3473BC66 *........... .R..*
*......L.........*
*....
*
MEMBER NAME ECE0004P CSECT NAME CSECT2
C6D6E4D5 C4E4D5D2 D5D6E6D5 40C8D6E2 *HOST MODULE NOT *
*FOUNDUNKNOWN HOS*
C9E5C540 C4E4D760 D2C5E840 C3C1D3D3 *T FUNCTIONRECURS*
*IVE DUP-KEY CALL*
C9C6C9C5 C4FFEE12 34C9D5E5 C1D3C9C4 *DUP-KEY NOT SPEC*
*IFIED....INVALID*
* MVE LENGTH
*
AMA113I COMPLETED DUMP REQUIREMENTS
AMA100I AMASPZAP PROCESSING COMPLETED
******************************************* BOTTOM OF DATA *******************************************
Chapter Ten - UMS Online Error Messages
180
Registry of Motor Vehicles – UMS Programmer’s Manual
11
Special System Functions
This chapter is essentially a continuation of Chapter 2, Control Dispatch. The system
functions described here are more specialized in their operation and were therefore
separated from the “main line” CD discussion.
Limited Secondary Session (LSS)
This service allows cursor selection of functions from within other functions, which are
not scroll functions, the execution of that function, and the return to the original function
at the exact point of exit. This is similar to sub-routine execution. The service works in
conjunction with the PA1 secondary-session facility. The LSS session differs from the
PA1 facility in that, when invoked, a function-name and surrogate are passed to the
session. In this mode, the user cannot change the function (prohibited by Control
Dispatch) and the only function keys allowed are 7, 8, 9, and 12. All other function keys
are treated as a “return to ordinary session” request. The only function changes which
can occur are those accomplished by internal dispatch. The user is allowed to change key
fields for the invoked function.
The concept of “reference list” is introduced. This list is very similar to the scroll table
but is located in other storage media. It is intended to provide a cursor selection entry to
the LSS which is independent of the scroll facility and is a detailed reference mechanism
to it.
As with F6 (screen hop), any function which can receive a F4 selection is eligible to
receive this service and cannot differentiate it from a F4 entry. F3 is used for cursor
selection from a reference-list, and can only be used from their primary session. Any
program is eligible to build a reference list and no PCTEG entry is required for this
eligibility. Whenever a function change occurs on the guest (even if it occurs via internal
dispatch or host function swap), any existing reference-list is purged. A module was built
to handle the reference-list. Its name is stored in guest common in the eight bytes
following the name of the internal dispatch module.
The reference list itself is built in the end of the map-output area. This should require no
special changes as LXTABLE manages these areas. If the program does not use the
LXTABLE mechanism for mapping it will have to take care in the use of the storage.
After a link to the reference list manager the 572 bytes of the output map area are cleared
by the manager. Applications must not use this space unless they call the manager. If
they do use this space, it may confuse LXTBL or SENDBACK. A DSECT for the area is
in Appendix B. If the reference list manager is called with entries-per-line equal to low-
Chapter Eleven - Special System Functions
181
Registry of Motor Vehicles – UMS Programmer’s Manual
values, the reference list will be purged. Each call to the manager sets a return code in
the guest common error-code. If it is non-zero, the application should exit and allow the
error to be posted. The manager is called by a CICS LINK passing guest common.
Because a LINK is involved and the manager stores the reference list on external media,
excess calls MUST be avoided.
UMS Screen Hop Facility
Screen hop is defined as a mechanism of transferring from one business function to
another where the logical business key being accessed in the first function presents the
external appearance of being automatically transferred to the second. In UMS, the
terminal operator will indicate a desire to accomplish such a transfer by means of F6. In
the context of such a transfer, the business function during which F6 is pressed is referred
as the “hop-from” function, and the new function keyed at the top of the screen is
referred to as the “hop-to” function.
From a technical perspective, the use of F6 will be transparent to the hop-to function. On
entry to this function, the terminal operator’s use of F6 will be indistinguishable from use
of F4. The entry-reason code will contain the same value, and the F4/F9 surrogate
type/value will be setup in the same fashion. The 60 bytes in guest common called
UGSURLST, which was previously not referenced (but reserved for screen-hop usage)
and defined as 15F has undergone a definition change. It is now 12(CL1,FL4). This
causes it to still be 60 bytes long, but provides for surrogate-types as well as surrogate
values.
The hop-from function has some responsibility in the use of this 60 byte area, as well as
the control-dispatch software. In order to properly use the 60 byte area, all functions
must be categorized relative to this area. The possible categorizations are:
A.
B.
C.
D.
primary
supportive
neutral
primary & supportive
A function defined as primary puts definitive information in the table. It typically
operates from a definitive key. Examples of this type of function are ULI and URI. ULI
would place a PERS surrogate and type in the table. URI would place PERS, VEHR,
VEHT, VEHC, and VMOD surrogates and types in the table. Because these are primary
functions, they have sole responsibility for the table. Therefore, before going to the host
to read a record they must move low-values to the table. After a successful return from
the host, they must place the appropriate surrogate types and values in the table. The
order in which the entries are placed in the table is unimportant to the control - dispatch
functions, but does represent the order in which the entries are evaluated during an F6
transfer, and thus can be viewed as a priority definition mechanism.
Chapter Eleven - Special System Functions
182
Registry of Motor Vehicles – UMS Programmer’s Manual
Example:
ULI, before going to host:
MOVE LOW-VALUES TO UGCOMMON-RESERVED-SURROGATES.
Example:
ULI after successful return from host:
MOVE '4' TO UGCOMMON-RESERVED-SURR-TYPE(1).
MOVE RMV-PERS-SURROGATE
TO UGCOMMON-RESERVED-SURR-VALUE(1).
A function defined as supportive adds information to the table. It is usually used to get
more information about a primary key. The primary key would generally have been
entered on a previous screen. An example of this in ALAR would be SP. SP typically
operates from an existing VEHR or PERS key, and gets parking offense data
(INCD-OFNS & ACTN surrogates). If this function were implemented in UMS, before
going to the host with an existing key, it would SEARCH the table and if it found any
type entries which were INCD-OFNS or ACTN it would put low-values in the type entry.
After a successful return from the host, it would again search the table, and use the first
entries with low-values in the surrogate-type for its INCD-OFNS and ACTN entries.
Example:
SP, before going to host:
2222-SETUP-TABLE.
SET UGCOMMON-RESERVED-SURR-INDEX TO 1.
2222-SEARCH-TABLE.
SEARCH UGCOMMON-RESERVED-SURR-LIST
WHEN
UGCOMMON-RESERVED-SURR-TYPE(UGCOMMON-RESERVED-SURR-INDEX)
= (incd-ofns-surr-type OR actn-surr-type)
MOVE LOW-VALUES TO
SET UGCOMMON-RESERVED-SURR-INDEX UP BY +1
GO TO 2222-SEARCH-TABLE.
2222-EXIT.
EXIT.
Example: SP after successful return from host:
3333-FIXUP-TABLE.
SET UGCOMMON-RESERVED-SURR-INDEX TO 1.
SEARCH UGCOMMON-RESERVED-SURR-LIST
AT END GO TO 3333-EXIT
WHEN
UGCOMMON-RESERVED-SURR-TYPE(UGCOMMON-RESERVED-SURR-INDEX) =
LOW-VALUES
MOVE INCD-OFNS-SURR-TYPE TO
UGCOMMON-RESERVED-SURR-TYPE(UGCOMMON-RESERVED-SURR-INDEX)
MOVE INCD-OFNS-SURR-VALUE TO
UGCOMMON-RESERVED-SURR-VALUE(UGCOMMON-RESERVED-SURR-INDE
X)
SET UGCOMMON-RESERVED-SURR-INDEX UP BY +1.
SEARCH UGCOMMON-RESERVED-SURR-LIST
AT END GO TO 3333-EXIT
Chapter Eleven - Special System Functions
183
Registry of Motor Vehicles – UMS Programmer’s Manual
WHEN
UGCOMMON-RESERVED-SURR-TYPE(UGCOMMON-RESERVED-SURR
-INDEX) = LOW-VALUES
MOVE ACTN-SURR-VALUE TO
UGCOMMON-RESERVED-SURR-TYPE(UGCOMMON-RESERVED-SURR
-INDEX)
MOVE ACTN-SURR-VALUE TO
UGCOMMON-RESERVED-SURR-VALUE(UGCOMMON-RESERVED-SUR
R-INDEX)
SET UGCOMMON-RESERVED-SURR-INDEX UP BY +1.
3333-EXIT.
EXIT.
A function defined as neutral does not change the table.
A function defined as primary and supportive may need both types of logic mentioned
above. SP might be an example of this if it is entered by other than (F4 or F6) and a
license# or regno key directly keyed.
The expression of the above categorizations is in the code contained within the
applications functional processors. No UMS tables are changed for this support. The
decisions relative to the categorizations are a business type decision. For UMS versions
of existing ALAR applications, these decisions are made by duplicating existing ALAR
functionality. For new applications, a specification level decision is required.
UMS control-dispatch will clear the above mentioned 60 bytes whenever a
function-change occurs without the pressing of F6.
ALARS-UMS Bridge
The bridge is a generic name for several software components that allow the user
semi-automatic transition between the two major application control/dispatch
(supervisory) systems WITHOUT the user being required to log-off one and logon to the
other. In this respect, the bridge is like a session-manager. Additionally, the bridge
automatically performs some data passing functions between the systems and provides a
semi-smooth transition between some of the differences across the systems. In particular,
the bridge passes (in both directions) data for screen hopping and in this area provides
functionality dependent on an intimate knowledge of both applications and beyond that
provided by session management software.
The bridge assumes that a user will log on to ALAR. Thereafter, if they invoke a UMS
function (such as LI or LX), an automatic transfer to UMS (and the selected function)
will occur. At such time as the user selects (from the UMS side) an ALAR function
(such as LS), an automatic transfer back to ALAR (and the selected function) will occur.
Chapter Eleven - Special System Functions
184
Registry of Motor Vehicles – UMS Programmer’s Manual
If the user logs directly onto UMS (does not come from ALAR) and issues an ALAR
function, they will be forced to the ALAR signon screen, and any screen-hop data will be
lost. In a similar fashion, if the user changes signon-id while at the UMS side, the same
result will occur.
True UMS Guests can not get into ALAR via the bridge. The bridge is only functional if
(1) the UMS guest is in HOST=GUEST mode (not a true LU6.2 GUEST) and (2) there is
a real ALAR system in the same CICS region.
The bridge is bi-directional, but uses different software in each direction. From the
ALAR side, there needs to be a normal MRMXDTBL entry for each function recognized
as being processed on the UMS side. Each of these functions must point at MLIP090P.
It makes no difference if the MRMXDTBL entry is setup as an update entry or not. All
the normal security provisions must be present. Of course, the target function must exist
on the UMS side. No changes are required to the UMS side.
Coding in MRMXDTBL and MRMP010C assumes that the function-name section of
MRMXDTBL has a fixed maximum length and is then followed by the program-name
section. Coding in UMS does not rely on the fixed maximum length, but does assume
that there will be at least 1 unused entry (high-value key) in MRMXDTBL. This has no
effect or consequence for the foreseeable future. However, at such time as enough
additional functions might be added to MRMXDTBL to EXACTLY fill the
function-name section, the bridge would cease to work (at this time, no more functions
could be added to ALAR without recompilation of MRMP010C and a change to the base
number of functions). Thus there is a difference of 1 between the point where
MRMP010C needs to be modified because of the requirements of the bridge and the
point where MRMP010C needs to be modified because of the requirements of its own
functionality and limitations. In neither case does the UMS code need to be modified.
Also, many functions need to be added to MRMXDTBL before this problem occurs.
At run time, if a UMS guest is running HOST=GUEST, AND there is an ALAR in the
same CICS region, an alternate PCTEG table is dynamically built at guest startup to
reflect the ALAR functions. When UMS detects a function-change, it searches first in
the UMS PCTEG table, next in the function-alias table and finally in the dynamically
generated ALAR PCTEG table. At startup time, the entries generated into the ALAR
PCTEG table reflect each ALAR function which is not mapped to the ALAR side bridge
program (MLIP090P). The combination of this action AND the UMS search order insure
that a loop of switching between the systems will not occur. The UMS initialization code
includes two tables. These tables are referred to as a SPECIFIC function table and a
GENERIC function table. These two tables enable UMS to decide what types of
surrogate entries to map into the dynamically generated PCTEG entries. If a function is
found in the SPECIFIC table, the surrogate-type string contained there is propagated into
the generated PCTEG entry. If not, the GENERIC table is searched for the first byte of
the function. If it is found, the associated surrogate-type string is propagated into the
generated PCTEG entry. In any other case, the function cannot carry screen-hop data
from UMS to ALAR.
Chapter Eleven - Special System Functions
185
Registry of Motor Vehicles – UMS Programmer’s Manual
From ALARS to UMS, when MLIP090P is invoked, it must differentiate between a
screen hop and a simple transfer occurs. To do this, it matches the selected
function-name first to the UMS Guest's PCTEG and second to the UMS Guest's
function-alias table. After getting a hit, it interrogates any PFC surrogate string inherent
in the entry. If the PFC surrogate strings exist, any surrogates stored in the terminals
ALAR common area are checked for being non-null and of a type specified in the PFC
surrogate string. This checking is done in the priority order specified by the UMS
surrogate string definition. If a match occurs, the appropriate surrogate value is passed to
the UMS application just as if a user totally within UMS had accomplished a transfer
between two UMS applications with PFC. This results in the bridge making the same
judgement that ALAR applications make for screen-hop. It also causes PFC selection to
work.
From UMS to ALAR, deciding if the call is for a screen hop or a simple transfer is much
simpler than ALAR to UMS. In this case, the UMS system knows explicitly if a
screen-hop is requested, and what kind of selection the target function accepts.
Assuming that the SPECIFIC and GENERIC tables used at UMS startup are accurate
reflections of the applications ability, the correct transfer will always occur, or an error
message indicating that the user has requested an impossible transfer will occur.
The bridge’s function is invoked only at the time of transition between the two systems.
While one is functioning in either system, the bridge is not operative. Thus, the user is
subject to the rules of whichever system they are in at the moment. There are very few
areas of difference. These differences should not present a problem.
GHOST Program - UNI / NDR / CDLIS
The external system interface, as used to communicate with NDR, is called the Unified
Network Interface (UNI). It is an integration of the UNI/CDLIS product, the various
CICS regions used at RMV, the ALAR product, and the UMS host/guest structure.
The design objectives of this software are:
1. To provide a common point of transmission to NDR
2. To provide a common point of receipt from NDR
3. To provide a mechanism of recovery from an NDR-down condition (or
network-down) which is independent of manual interaction
4. To relieve the broad local application set from responsibility in the exact
nuances of the UNI structure
Chapter Eleven - Special System Functions
186
Registry of Motor Vehicles – UMS Programmer’s Manual
5. To automatically relate the source of an inquiry (CICS/IDMS) to and from the
associated UNI environment.
The Major Components are:
A.
Routing Table - This is a table which relates the various CICS regions (by
ACB name) with their associated IDMS regions and their host UNI region
B.
Transfer File - This is a VSAM dataset used to hold the record of an
inquiry (currently only to NDR) and its eventual response. There is one
transfer file for each associated IDMS region. The transfer file(s) are
owned by the associated UNI region
C.
Send Program - This is a module which converts the applications intention
to query NDR to a properly formatted inquiry, and routes this inquiry to
the appropriate ESI region. It is responsible for obtaining the necessary
data from the database, determining if test or production status is
appropriate and for formatting the data according to the proper parameters.
It runs in the CICS region initiating the interaction and uses remote
resources in the UNI region.
D.
Receipt Program - This is a module which converts an ESI response into
transfer-file format, and adds it to the transfer-file. It also processes a
variety of errors which might be reported by UNI. It runs only in the UNI
region(s) and differentiates which transfer file the various responses might
belong on. It performs no database access and does not depend on the
originating application region being up.
E.
LX - This is an application function written in UMS format which uses
UMS host functions to exercise each of the above components/functions.
It can invoke host functions which cause initiation of the send program
(issue an NDR inquiry), display the results of the receipt program, create
noncash records based on responses and delete responses.
F.
The Ghost - This is the cleanup function. It is more completely described
below.
This software is designed to view its environment as a set of concurrently executing
independent processes with a small amount of overlap (or intersection). The processes
are:
1. The originating application region
2. The associated UNI region
3. The target system as linked through UNI
Chapter Eleven - Special System Functions
187
Registry of Motor Vehicles – UMS Programmer’s Manual
In a practical example, an inquiry process initiated through LX would involve the
following steps:
GUEST
initiate request
HOST
UNI
NDR
send to UNI
send to NDR
execute
rqst
respond
reformat
& store
__________________________________
______ UMS-NDR Query ______| UMS-NDR 'Reply'
Request complete ---->
request display data <------------------------------------retrieve data from UNI
Check completion
and get data if
complete
return data
display data
Please note that the above processes are asynchronous. That is, once the initiation
sequence is complete, the guest operator is free to perform any other function (LX or
other), and return to examining the response at some time in the future (an hour, a day).
There may be no response before the end of the day. The operator can, if they so desire,
go to LX to await a response which should normally return in a minute or so.
Since these processes are not connected synchronously, and in reality cannot be unless all
processing is to be suspended if some remote component is down, there needs to be some
mechanism which deals with the various problems which will arise when one of the
following occurs:
♦ All does not go perfectly
♦ There is no operator waiting to take action for the response on LX
♦ The transfer-file needs to be maintained
The mechanism providing these services is known as the ghost (program, UHL0020P).
The ghost program exists in CICS regions and there is one for each associated IDMS
database. In cases where more than one CICS is connected to a single IDMS, the ghost
runs in only one of the CICS regions: the one with the fewest service hours. For
example, the CV11 ghost runs in the PROD region.
Chapter Eleven - Special System Functions
188
Registry of Motor Vehicles – UMS Programmer’s Manual
The GHOST is configured as a UMS Guest. It is free running time-initiated software
which signs itself on to a UMS host (just as an insurance company would) and issues
UMS host functions. It is a unique guest (perhaps very similar in concept to ISI’s
software) since it does NOT use the standard guest packaging, but only uses the standard
guest interface program to communicate with its host.
The ghost is configured to run automatically at intervals throughout the day. When it
runs, it examines records on the transfer-file and uses the same host functions used by LX
to take various actions:
1. If an inquiry to NDR has been sitting without a response for an unacceptably
long interval AND there is evidence that NDR is (now) active, the inquiry is resent.
2. If a response from NDR has been sitting without action for a defined interval
(where the interval is dependent on source and content), it is automatically
applied.
3. If an applied response from NDR has been sitting for a defined interval (45
days) it is deleted.
When the ghost program runs it produces a report of activity as an audit trail.
Chapter Eleven - Special System Functions
189
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Eleven - Special System Functions
190
Registry of Motor Vehicles – UMS Programmer’s Manual
12
UMS Batch
Tape Processing
Insurances companies send tapes (reels or cartridges) to the Registry. These tapes
contain UMS transactions to be processed against the Registry’s database. Tapes
received must have either UMSTEST or UMSTRNS as the dataset names. UMSTYEST
datasets will be run against the CV14 database while UMSTRNS datasets will be run
against the CV11 database. The following steps document the handling of UMS tapes.
1.
The insurance companies will send tapes to production control. The
control log for each tape should be verified with the tapes received.
2.
After the control log has been verified, each tape should be separately run
through the tape verification job. This job can be run anytime during the
day to verify tapes to be processed that night. The purpose of the
verification job is to screen the tapes before they are input to the clist.
This will prevent abends from occurring later in the cycle. The volser,
tape type (tape or cart), and ICO number must be entered into the JCL.
The jobs can be found in MSTRJCL. These jobs will verify the data-set
name, ICO number, and transaction count. These jobs will only process
one tape at a time and must be run for each tape prior to input into the clist
for batch processing.
3.
Upon execution of the tape verification job, the sysout in the hold-queue
must be checked. If the return code is “00” the transaction count from the
job should be checked against the count on the corresponding control log.
If the counts match, the tape can be input into the clist. If the counts do
not match, the submitting insurance company is to be contacted about the
discrepancy. Listed below are abends and the proper action to take.
Chapter Twelve - UMS Batch
191
Registry of Motor Vehicles – UMS Programmer’s Manual
Abend
Description
Action
S813
Invalid Datatset name
2090
Missing JCL Parm
2120
Invaliud JCL parm length
2130
Mismatch on ICO
Contact the ICO
submitting tape
JCL parm must
be present
JCL parm must be
3 characters long
validate ICO parm
with control log
If the ICO on the control log does not match the ICO on the tape, the
submitting insurance company should be contacted and the tape returned.
4.
5.
After the UMS tapes have been verified, they may be entered into the
CLIST. The Clist is accessed through the “master Application Menu” in
TSO. From there either the production or CV14 CLIST is selected.
-
A security screen will appear. The password “STING” should be
entered.
-
The UMS Tape Log screen will be displayed.
-
UMS tapes are logged by entering the requested information. The
VOLSER out field is optional and, if not entered, will default to the
input VOLSER.
-
After logging all the input tapes to be processed, enter an “X” in the
process field at the top of the screen to exit the clist panel.
-
A message indicating the total number of tapes logged will display. If
the message does not display, an error has occurred. The input process
should be repeated if an error occurs.
Updating the UMS cycle window is critical to controlling the number of
tapes and transactions processed in the cycle. This clist is also accessed
from the “Master Application Menu.” The appropriate batch window is
selected (production or CV14).
-
The UMS cycle window screen will be displayed
-
Enter the time available for the UMS cycle to run in minutes.
-
Enter “X” in the process field to exit the clist panel.
Chapter Twelve - UMS Batch
192
Registry of Motor Vehicles – UMS Programmer’s Manual
-
6.
A message indicating the total number of transactions to be processed
will be displayed. If the message does not display, there is an error
and the entire process should be repeated.
If tapes are to be processed the jobs need to be run are B000, B010, and
B020. Monthly jobs must be run after B000 and B020.
Chapter Twelve - UMS Batch
193
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Twelve - UMS Batch
194
Registry of Motor Vehicles – UMS Programmer’s Manual
13
Record Surrogates
The database is, for the most part, a standard IDMS database. It is described, with
Bachman diagrams, in a separate document. These documents are maintained by DBAs.
The most unusual feature is the use of the ‘surrogate records.’ There are six surrogate
record types listed below. They are stored in single record-type areas with a key which is
a full-word binary number through the CAL-S algorithm, rather than the usual
IDMSCALC. The next surrogate number comes from a single instance of one recordtype, whose value is incremented and then replaced. The algorithm uses the surrogate
number essentially as the records ordinal position within the area. It can, with some
information about the area such as page size and SMI interval, derive the page it should
be stored on. The record goes in the calc chain for that page. If the area has only one
record type, the suggested page is always suitable and there is no overflow at all.
The beauty of this arrangement is that the area may be page-expanded, have pages added
or be unloaded and reloaded into new file extents with a new geometry. In any case, the
CAL-S algorithm will function undisturbed as the nth record in the area. It will always
be the nth, no matter what changes are made. This surrogate number, which is a unique
key for each of its record types, can be (and is) used as a calc-key for records, in other
areas, stored by IDMSCALC. The uniqueness and uniform size of these surrogate keys
have provided very good space-management results in the other areas. The surrogate
values are also stored as foreign keys in other record types. As with any foreign key, the
target (surrogate) record type is implied by its use.
The conversion from various sorts of keys, such as SSAN or vehicle registration number,
to a related surrogate is often made by the host software. In such a case, the host
controller, using the transaction’s PCTEH entry, invokes the first named module to
convert the ‘key value’ to a surrogate. If none is found, an error is returned. If one is
found, control goes to the second, and succeeding (if any), module(s) named in the
PCTEH entry to complete the business function processing. If two or more ‘matches’ are
found, the duplicate transaction specified is invoked to switch function and return the first
screen of duplicates.
On the applications side of the system, there are requirements to manipulate lists of
surrogate keys for multiple record types. To differentiate them, a one-byte prefix is
defined for the six types used and then prefixed to the 4-byte surrogate key. The six
types and their values are listed below. The following few lines from the copy book
UGZCOMMC show the structure in which they are placed.
Chapter Thirteen - Record Surrogates
195
Registry of Motor Vehicles – UMS Programmer’s Manual
10
UGCOMMON-RESERVED-SURROGATES.
15
UGCOMMON-RESERVED-SURR-LIST
OCCURS 12 TIMES INDEXED BY
UGCOMMON-RESERVED-SURR-INDEX.
20 UGCOMMON-RESERVED-SURR-TYPE
PIC X.
20 UGCOMMON-RESERVED-SURR-VALUE PIC S9(9) COMP.
The order for the record types (which may only be for a single type) is dictated for F4 and
F9 by the 1 to 4 type codes in the fields UGCOMMON-F4-STRING and UGCOMMONF9-STRING. These values are set by the System Control Program during initialization
from the values in the corresponding strings located in the PCTEG entry. The code
segment for these fields follows:
10 UGCOMMON-CUR-FUNC-CTRL-FLAGS.
15 UGCOMMON-PROCESS-BYTE-1
15 UGCOMMON-PROCESS-BYTE-2
15 UGCOMMON-PROCESS-BYTE-3
15 UGCOMMON-PROCESS-BYTE-4
15 UGCOMMON-USER-FLAGS.
20 UGCOMMON-PF4-STRING
20 UGCOMMON-PF9-STRING
PIC X.
PIC X.
PIC X.
PIC X.
PIC X(04).
PIC X(04).
For scrolling, there is a different table that will hold 140 surrogate keys only. The type
identification in this case is made from the 1 to 8 type codes stored in UGCOMMONSCROLL-SURR-TYPE-TBL. Whatever sequence is here is assumed to repeat enough
times to cover the number of surrogate keys shown by the index. The fields involved are
as follows:
05 UGCOMMON-SCROLL-BASE-DATA
PIC X(742).
05 FILLER REDEFINES UGCOMMON-SCROLL-BASE-DATA.
10 UGCOMMON-LAST-SCROLL-FUNC
PIC X(04).
10 FILLER
PIC X(02).
10 UGCOMMON-SCROLL-FORMAT
PIC X(12).
10 FILLER REDEFINES UGCOMMON-SCROLL-FORMAT.
15 UGCOMMON-SCROLL-ENT-PER-LINE
PIC 9.
15 UGCOMMON-SCROLL-SURR-PER-ENT
PIC 9.
15 UGCOMMON-SCROLL-DATA-LINE1
PIC S9(4) COMP.
15 UGCOMMON-SCROLL-SURR-TYPE-TBL PIC X(08).
NOTE: Intervening fields are omitted to save space. Refer to Appendix F
for a complete listing.
Chapter Thirteen - Record Surrogates
196
Registry of Motor Vehicles – UMS Programmer’s Manual
10 UGCOMMON-SCROLL-TABLE
PIC X(560).
10 FILLER REDEFINES UGCOMMON-SCROLL-TABLE.
15 UGCOMMON-SURR-NUMB OCCURS 140 TIMES
INDEXED BY UGC-SURR-INDEX
PIC S9(09) COMP.
05 UGCOMMON-APPLICATION-WORK-AREA
PIC X(512).
The 20 Types of ‘Application’ Surrogates defined are:
0 = VEHR [S] (registration)
1 = VEHC [S] (veh. claim)
2 = VEHT [S] (veh. title)
3 = VMOD [I] (veh. model)
4 = PERS [S] (person record)
5 = NOWN [S] (corp. owner)
6 = PLCY [S]
7 = OACD [S]
8 = OVID [S]
9 = OWTH [S]
A/B = CITA/ IVIO [S]
C = ACTN [S]
D = DECI [S]
E = PINQ [S]
F = AUTI [S]
G = SUBM [S]
H = SDIP XCLU [S]
M = REIN EXPA [S]
V = MSCD [S]
W = DISP [S]
Low-Values or Spaces = None
NOTE: [S] surrogate is key for record stored CAL-S
[I]
"
" " "
"
IDMSCALC
NOTE: Additional mention of surrogates is found in the screen-hop function
discussion on page 182.
Chapter Thirteen - Record Surrogates
197
Registry of Motor Vehicles – UMS Programmer’s Manual
Chapter Thirteen - Record Surrogates
198
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendices
Appendix A – Non-UMS LXTABLE Edit Example
199
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix A – Non-UMS LXTABLE Edit Example
200
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix A:
Non-UMS LXTABLE Edit Example
NON-UMS LXTABLE DISCUSSION
In its native form, the UMS guest provides a front and back end service mechanism
which accomplishes a number of common tasks. These tasks fall into three categories:
1.
2.
3.
Conversion of data from external format to internal format.
Editing of common characteristics and enforcement of high level business
rules upon input data.
Output conversion/formatting of internal data.
These services are grouped within a functionality unit known generically as LXTABLE.
The name itself is a relation to another service which was present in a different system,
and has no particular mnemonic relationship to the current system.
The intent of these services is to provide a table driven mechanism which performs
common functionality, and to insure that this exists in only one place in the system.
Further, the design is such that the component of the “rules” believed to be fluid is
resident on the HOST computer, and downloaded to each GUEST computer at startup
time each day. This allows the RMV flexibility within the rules while being able to avoid
frequent GUEST installations/maintenance.
Clearly, the business rules are of primary importance to the RMV, as is the following of
these rules by each GUEST. At the start of this document, the three tasks performed by
LXTABLE were outlined. The first two tasks would serve this purpose in any GUEST
site which is not running the native RMV GUEST. Since these services CAN be
accessed within a CICS region by programs which are NOT part of the native RMV
GUEST, the purpose of this package is to show how this can be done with an example
program written in COBOL.
In a native UMS GUEST application, the LXTABLE services are invoked automatically
by the dispatch/control services. The application program is not invoked if errors are
detected. In a similar fashion, the conversion for output is automatic and transparent to
the application. If the reader tries to compare the sample COBOL program with any
UMS application, the conclusion is that there is no similarity. The reason for this is that
in a NON UMS application, the application program is required to perform various
functions which normally are the responsibility of the dispatch/control function.
Appendix A – Non-UMS LXTABLE Edit Example
201
Registry of Motor Vehicles – UMS Programmer’s Manual
In essence, the functionality of LXTABLE is simple. The programmer must construct an
editing/conversion template (known as the LXTABLE). This load module is truly a table
which relates input areas (raw data) with storage locations for processing (in a
COMMAREA), describes how they are to be converted as well as describes what generic
class of editing is to be applied.
When the editing function is invoked, the relations are processed based on the table.
Conversions are performed, default values may be inserted and editing specifications are
checked. If errors are detected, each is flagged along with the error-code applicable to
the first detected is returned. First detected relates to the order in which the fields were
specified in the LXTABLE. Normally, in the RMV usage, this relates to left-to-right,
top-to-bottom construct of the input screen. This is a convention, not a technical
requirement.
The process can handle all fields at once (as in the RMV usage), or process singular
groups of fields. The minimum number of fields in a group is those needed to analyze all
involved editing specifications. In the sample, which has two cases, one case (policy
dates) requires two fields and the other (registration) requires three fields.
If many groups of fields are processed together and it is important not merely to know if
ALL fields passed the edits (as in the sample), but which DID NOT, there is a simple
technique. Note that in the sample, an item called EDIT-THIS-FIELD is moved to a 3
byte KEY field for each item to be processed. If the status returns non-zero, each KEY
field which corresponds to an item which failed the edit will no longer have a value equal
to EDIT-THIS-FIELD.
Appendix A – Non-UMS LXTABLE Edit Example
202
Registry of Motor Vehicles – UMS Programmer’s Manual
Sample Map, Non-UMS LXTABLE Invocation
= BMS map used by sample program. Provided for reference only.=
= it has NO applicability to the use of the technique.
=
USAMPLE
DFHMSD
TYPE=MAP,
CTRL=(FREEKB,FRSET),
MODE=INOUT,
STORAGE=AUTO,
TERM=3270-2,
TIOAPFX=YES
USAMPLE DFHMDI
SIZE=(24,80)
DFHMDF POS=(001,023),LENGTH=0036,ATTRB=(ASKIP,BRT),
X00140000
INITIAL='EXAMPLE OF USING UMS EDIT
DFHMDF POS=(002,027),LENGTH=0028,ATTRB=(ASKIP,BRT),
INITIAL='FROM A NON-UMS APPLICATION'
*
DFHMDF POS=(005,001),LENGTH=13,INITIAL='POLICY EFFDT:',
ATTRB=ASKIP
FLD005A DFHMDF POS=(005,015),LENGTH=10,ATTRB=(UNPROT,IC,FSET)
DFHMDF POS=(005,026),LENGTH=07,INITIAL=' EXPDT:',
ATTRB=ASKIP
FLD005B DFHMDF POS=(005,034),LENGTH=10,ATTRB=(UNPROT,FSET)
DFHMDF POS=(005,045),LENGTH=1,INITIAL=' ',ATTRB=ASKIP
*
DFHMDF POS=(007,001),LENGTH=09,INITIAL='REG TYPE:',
ATTRB=ASKIP
FLD007A DFHMDF POS=(007,011),LENGTH=3,ATTRB=(UNPROT,FSET)
DFHMDF POS=(007,015),LENGTH=09,INITIAL=' NUMBER:',
ATTRB=ASKIP
FLD007B DFHMDF POS=(007,025),LENGTH=7,ATTRB=(UNPROT,FSET)
DFHMDF POS=(007,033),LENGTH=08,INITIAL=' COLOR:',
ATTRB=ASKIP
FLD007C DFHMDF POS=(007,042),LENGTH=1,ATTRB=(UNPROT,FSET)
DFHMDF POS=(007,044),LENGTH=1,INITIAL=' ',ATTRB=ASKIP
*
FLD014A DFHMDF POS=(014,001),LENGTH=79,ATTRB=ASKIP,INITIAL=' '
FLD015A DFHMDF POS=(015,001),LENGTH=79,ATTRB=ASKIP,INITIAL=' '
DFHMSD TYPE=FINAL
END
Appendix A – Non-UMS LXTABLE Edit Example
203
Registry of Motor Vehicles – UMS Programmer’s Manual
Program Sample, Non-UMS LXTABLE Invocation
IDENTIFICATION DIVISION.
PROGRAM-ID.
USAMPLEP.
DATE-COMPILED.
ENVIRONMENT DIVISION.
DATA DIVISION.
WORKING-STORAGE SECTION.
01 DATA-WORK-ITEMS.
===============================
these items are relative to
=
this sample program only,
=
and not the general technique =
v
04 TEMP PIC S9(9) COMP.
04 MAPAREA.
00190005
08 MA-TIOT-PREFIX PIC X(12).
08 MA-FLD005A.
12 MA-FLD005A-LEN PIC S9(4) COMP.
12 MA-FLD005A-ATTR PIC X.
12 MA-FLD005A-DATA PIC X(10).
08 MA-FLD005B.
12 MA-FLD005B-LEN PIC S9(4) COMP.
12 MA-FLD005B-ATTR PIC X.
12 MA-FLD005B-DATA PIC X(10).
08 MA-FLD007A.
12 MA-FLD007A-LEN PIC S9(4) COMP.
12 MA-FLD007A-ATTR PIC X.
12 MA-FLD007A-DATA PIC X(3).
08 MA-FLD007B.
12 MA-FLD007B-LEN PIC S9(4) COMP.
12 MA-FLD007B-ATTR PIC X.
12 MA-FLD007B-DATA PIC X(7).
08 MA-FLD007C.
12 MA-FLD007C-LEN PIC S9(4) COMP.
12 MA-FLD007C-ATTR PIC X.
12 MA-FLD007C-DATA PIC X(1).
08 MA-FLD014A.
12 MA-FLD014A-LEN PIC S9(4) COMP.
12 MA-FLD014A-ATTR PIC X.
12 MA-FLD014A-DATA PIC X(79).
08 MA-FLD015A.
12 MA-FLD015A-LEN PIC S9(4) COMP.
12 MA-FLD015A-ATTR PIC X.
Appendix A – Non-UMS LXTABLE Edit Example
00110000
00120000
00130000
00140000
00150000
00160000
00170001
00180001
00200005
00210005
00220005
00230005
00240005
00250005
00260005
00270005
00280005
00290005
00300005
00310005
00320005
00330005
00340005
00350005
00360005
00370005
00380005
00390005
00400005
00410005
00420005
00430005
00440005
00450005
00460005
00470005
204
Registry of Motor Vehicles – UMS Programmer’s Manual
12 MA-FLD015A-DATA PIC X(79).
04 END-MESSAGE PIC X(27) VALUE
'END OF EDIT-SAMPLE SESSION'.
04 MAPLENGTH PIC S9(4) COMP VALUE +222.
04 CONSTANT-1 PIC S9(4) COMP VALUE +125.
04 FILLER REDEFINES CONSTANT-1.
00530001
08 FILLER PIC X.
08 HEX-7D PIC X.
^
===============================
===============================
these items are constants
=
applicable to the RMV data
=
structures
=
v
04 CONSTANT-2 PIC S9(9) COMP VALUE +32768.
04 FILLER REDEFINES CONSTANT-2.
00570005
08 FILLER PIC XX.
08 NULL-DATE PIC XX.
04 CONSTANT-3 PIC S9(9) COMP VALUE +256.
04 FILLER REDEFINES CONSTANT-3.
08 FILLER PIC X.
00620008
08 EDIT-THIS-FIELD PIC XXX.
00480005
00490001
00500001
00510005
00520001
00540001
00550001
00560005
00580005
00590005
00600008
00610008
00630008
===============================
===============================
this is the structure which
=
defines the area containing
=
the raw data to edit and
=
convert. the 93 byte area at =
the start is required by the =
technique. the other items
=
must line up with the
=
template (LXTABLE). the 3byte =
field (....-key) preceeding
=
each data item is required
=
v
04 DUMMY-AREA.
08 DA-HEADER
PIC X(93).
00650007
08 DA-FLD005A.
12 DA-FLD005A-KEY PIC X(3).
Appendix A – Non-UMS LXTABLE Edit Example
00640006
00660006
00670006
205
Registry of Motor Vehicles – UMS Programmer’s Manual
12
08
12
12
08
12
12
08
12
12
08
12
12
DA-FLD005A-DATA
DA-FLD005B.
DA-FLD005B-KEY
DA-FLD005B-DATA
DA-FLD007A.
DA-FLD007A-KEY
DA-FLD007A-DATA
DA-FLD007B.
DA-FLD007B-KEY
DA-FLD007B-DATA
DA-FLD007C.
DA-FLD007C-KEY
DA-FLD007C-DATA
^
===============================
PIC X(10).
PIC X(3).
PIC X(10).
PIC X(3).
PIC X(3).
PIC X(3).
PIC X(7).
PIC X(3).
PIC X(1).
===============================
these items are relative to
=
this sample program only,
=
and not the general technique =
v
04 MSG1.
08 FILLER PIC X(8) VALUE ' EFFDT:'.
08 M1F1.
12 M1F1-MONTH PIC 99.
12 M1F1-DASH1 PIC X.
12 M1F1-DAY PIC 99.
12 M1F1-DASH2 PIC X.
12 M1F1-YEAR PIC 9999.
08 FILLER PIC X(8) VALUE ' EXPDT:'.
08 M1F2.
12 M1F2-MONTH PIC 99.
12 M1F2-DASH1 PIC X.
12 M1F2-DAY PIC 99.
12 M1F2-DASH2 PIC X.
12 M1F2-YEAR PIC 9999.
08 FILLER PIC X VALUE ' '.
08 M1F3.
12 M1F3-ERROR PIC X(6).
12 M1F3-CODE PIC 9(9).
04 MSG2.
08 FILLER PIC X(8) VALUE ' REGNO:'.
08 M2F1-PREFIX PIC X(4).
08 M2F1-REGNO PIC X(8).
08 M2F1-COLOR PIC X(2).
08 FILLER PIC X(14) VALUE SPACES.
08 FILLER PIC X VALUE ' '.
Appendix A – Non-UMS LXTABLE Edit Example
00680006
00690006
00700006
00710006
00720006
00730006
00740006
00750006
00760010
00770006
00780006
00790010
00800006
00810006
00820006
00830006
00840009
00850006
00860009
00870006
00880006
00890006
00900006
00910009
00920006
00930009
00940006
00950006
00960006
00970006
00980006
00990006
01000010
01010010
01020010
01030010
01040010
01050010
01060010
206
Registry of Motor Vehicles – UMS Programmer’s Manual
08 M2F3.
12 M2F3-ERROR PIC X(6).
12 M2F3-CODE PIC 9(9).
01070010
01080010
01090010
===============================
LINKAGE SECTION.
01100000
===============================
these items are relative to
=
this sample program only,
=
and not the general technique =
NOTE that a BLL cell for a UMS=
GUEST common area is needed
=
but its position depends on
=
the actual program structure =
v
01 DFHCOMMAREA.
01110000
04 FILLER PIC X(4).
01120000
01 FILLER.
01130000
05 FILLER
PIC S9(9) USAGE COMP.
01140000
05 UMS-COMMAREA-ADDRESS
PIC S9(9) USAGE COMP.
===============================
===============================
this copybook (or an equiv=
alent) is required.
=
01 UGCOMMON-COMMAREA.
02 UGZCOMMA.
COPY UGZCOMMC.
^
===============================
===============================
this filler provides access to=
a field normally reserved for =
dispatch/control and also
=
positions for definitions of =
the output fields from the
=
edit process.
=
v
02 FILLER REDEFINES UGZCOMMA.
04 FILLER PIC X(16).
04 UGCALLON PIC X.
04 FILLER PIC X(1767).
01220001
^
Appendix A – Non-UMS LXTABLE Edit Example
01160001
01170001
01180001
01190001
01200001
01210001
207
Registry of Motor Vehicles – UMS Programmer’s Manual
===============================
* OUTPUT DATA FIELDS COME HERE. THEY MUST BE AT THE SAME OFFSETS
*
WITHIN GUEST COMMON AS EXPRESSED IN THE ASSOCIATED LXTABLE.
* EACH IS PRECEEDED BY ITS Z AND T FIELD BYTES.
===============================
these fields receive the
=
output from the edit process. =
the "...Z" and "...T" fields =
are required by the technique.=
the "Z" fields may be useful =
for the purposes of editing
=
from a non-UMS application,
=
but the "T" fields are not.
=
v
04 SAEFFDT-GROUP.
01260006
08 SAEFFDT-Z PIC X.
08 SAEFFDT-T PIC X.
08 SAEFFDT PIC XX.
04 SAEXPDT-GROUP.
01300006
08 SAEXPDT-Z PIC X.
08 SAEXPDT-T PIC X.
08 SAEXPDT PIC XX.
04 SAPREFIX-GROUP.
08 SAPREFIX-Z PIC X.
08 SAPREFIX-T PIC X.
08 SAPREFIX
PIC X(3).
04 SAREGNO-GROUP.
01380006
08 SAREGNO-Z PIC X.
08 SAREGNO-T PIC X.
08 SAREGNO PIC X(7).
01410006
04 SACOLOR-GROUP.
01420006
08 SACOLOR-Z PIC X.
08 SACOLOR-T PIC X.
08 SACOLOR PIC X(1).
01450010
^
===============================
PROCEDURE DIVISION.
0000-SETUP-PROGRAM.
===============================
Appendix A – Non-UMS LXTABLE Edit Example
01270006
01280006
01290006
01310006
01320006
01330006
01340006
01350006
01360006
01370006
01390006
01400006
01430006
01440006
01460000
01470000
208
Registry of Motor Vehicles – UMS Programmer’s Manual
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
**** TEST FOR FIRST-TIME THROUGH,
**** SEND FIRST EMPTY SCREEN IF SO:
01480001
IF EIBCALEN = ZERO
01490001
EXEC CICS SEND MAP('USAMPLE') MAPONLY ERASE
FREEKB END-EXEC
01510001
EXEC CICS RETURN COMMAREA(TEMP) LENGTH(4)
TRANSID(EIBTRNID) END-EXEC.
01530001
******* INPUT MAP:
01540001
EXEC CICS RECEIVE MAP('USAMPLE') INTO(MAPAREA)
NOHANDLE END-EXEC.
01560001
******* TEST TERMINATION (ANY KEY EXCEPT ENTER):
01570001
IF EIBAID NOT = HEX-7D
01580001
EXEC CICS SEND TEXT FROM(END-MESSAGE) CURSOR(1)
LENGTH(27) ERASE FREEKB END-EXEC
01600001
EXEC CICS RETURN END-EXEC.
01610001
^
===============================
===============================
UIGETCOM returns a skeleton
=
UMS common area with a number =
of address constants plugged =
v
******* GET A UMS-GUEST COMMON AREA:
EXEC CICS LINK
PROGRAM('UIGETCOM')
01630001
COMMAREA(UMS-COMMAREA-ADDRESS)
01640001
LENGTH(4) END-EXEC.
01620001
01650001
===============================
===============================
tell COBOL that a related BLL =
cell has changed
=
v
SERVICE RELOAD UGCOMMON-COMMAREA.
^
===============================
Appendix A – Non-UMS LXTABLE Edit Example
01660000
209
Registry of Motor Vehicles – UMS Programmer’s Manual
******* INITIALIZE CONSTANTS NORMALLY PROVIDED BY
DISPATCH-CONTROL
===============================
the edit functions require the=
current date in RMV format
=
get it from CICS in Julian
=
format and use the UMS service=
module to convert it to the
=
RMV format
=
MOVE EIBDATE TO UGCOMMON-DATE-JULIAN-FORMAT.
01680005
MOVE '2' TO UGCOMMON-DATE-INPUT-FORMAT.
01690005
CALL 'UICALLST' USING UGCOMMON-DATE-ROUTINE-ADDRESS
UGCOMMON-COMMAREA.
01710005
MOVE UGCOMMON-DATE-BINARY-FORMAT TO
01720005
UGCOMMON-CURRENT-BINARY-DATE.
01730005
^
===============================
===============================
setup items required to show =
that the next phase is edit
=
v
MOVE +01 TO UGCOMMON-ENTRY-REASON.
MOVE 'Y' TO UGCOMMON-MESSAGE-TEXT.
^
===============================
01740005
01750005
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
******* DO SOME PROCESSING RELATIVE TO
*******
THE TEST MAP WE JUST INPUT:
MOVE SPACES TO MA-FLD014A-DATA, MA-FLD015A-DATA.
IF MA-FLD005A-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD005B-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD007A-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD007B-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD007C-DATA = (LOW-VALUES OR SPACES)
MOVE 'NO DATA WAS ENTERED' TO MA-FLD014A-DATA
GO TO 9999-EXIT.
01840005
^
===============================
===============================
Appendix A – Non-UMS LXTABLE Edit Example
210
Registry of Motor Vehicles – UMS Programmer’s Manual
DUMMY-AREA will contain data =
to be edited. in fact, the
=
edit services will treat it as=
if it were an input map
=
composite. a valid length is =
required.
=
v
******* CONSTANT BELOW SHOULD REPRESENT THE TRUE LENGTH
DUMMY-AREA
MOVE +58 TO UGCOMMON-RECEIVED-MAP-LENGTH.
^
===============================
===============================
since DUMMY-AREA is equivalent=
to a map, its address is
=
required in both map address =
cells in the common area. UMS =
services can be used to get
=
this value:
=
v
******* ESTABLISH ADDRESSES OF DUMMY MAP AREA:01870006
CALL 'UICALLST' USING UGCOMMON-DATA-NAME-ADDRESS
DUMMY-AREA, UGCOMMON-INPUT-MAP-ADDRESS.
MOVE UGCOMMON-INPUT-MAP-ADDRESS TO
UGCOMMON-OUTPUT-MAP-ADDRESS.
^
===============================
===============================
the name of the user const=
ructed edit template (LXTABLE)=
must be placed in the common =
area
=
v
******* SET EDIT-TABLE NAME:
01920006
MOVE 'USAMPLET' TO UGCOMMON-MAP-TRANSLATION-TBL.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
*******
*******
Appendix A – Non-UMS LXTABLE Edit Example
01940006
01950006
211
Registry of Motor Vehicles – UMS Programmer’s Manual
******* PROCESS EFFDT/EXPDT:
01960006
*******
01970006
IF MA-FLD005A-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD005B-DATA = (LOW-VALUES OR SPACES)
MOVE 'NO POLICY DATE(S)' TO MA-FLD014A-DATA
GO TO 1000-DO-REGNO.
^
===============================
===============================
the edit services normally are=
used to process many fields at=
the same time. this technique =
edits all fields, but the ret-=
urned code is only for the 1st=
error, with the checking in
=
the order the definitions
=
occur in the template. this
=
example makes multiple passes =
to show all codes. the verbage=
documentation describes how
=
to tell which fields are in
=
error if multiple fields are =
edited at once.
=
v
******* THE NEXT 4 LINES OF CODE ARE IN ORDER FOR EACH
*******
EDITING PASS:
MOVE LOW-VALUES TO UGCOMMON-PROGRAM-COMMAREA.
MOVE HIGH-VALUES TO UGCALLON.
MOVE ZERO TO UGCOMMON-CURRENT-ERROR-CODE,
UGCOMMON-CURRENT-MAP-LENGTH.
^
===============================
===============================
the conversion output fields =
must be set to the default
=
value for the field mode.
=
v
******* INITIALIZE INVOLVED FIELDS TO DEFAULT VALUE(S)
02070006
MOVE NULL-DATE TO SAEFFDT, SAEXPDT.
02080006
^
===============================
===============================
Appendix A – Non-UMS LXTABLE Edit Example
212
Registry of Motor Vehicles – UMS Programmer’s Manual
only the fields to edit are
=
set in DUMMY-AREA. they must =
be flagged as edit candidates.=
v
******* CLEAR DUMMY-AREA, PLUG INVOLVED FIELDS:
MOVE LOW-VALUES TO DUMMY-AREA.
MOVE MA-FLD005A-DATA TO DA-FLD005A-DATA.
MOVE MA-FLD005B-DATA TO DA-FLD005B-DATA.
******* INDICATE WHICH FIELDS ARE TO BE PROCESSED:
MOVE EDIT-THIS-FIELD TO DA-FLD005A-KEY
DA-FLD005B-KEY.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
MOVE SPACES TO MA-FLD005A-DATA, MA-FLD005B-DATA.
^
===============================
===============================
invoke the edit process. note =
that a UGCA abend means that =
the UMS commarea was not
=
obtained properly. a UGTL
=
abend means that there is not =
a running UMS guest in the
=
region. UGTL only occurs if
=
the particular edit requires =
host download data.
=
v
******* INVOKE THE EDIT PROCESS:
EXEC CICS LINK
PROGRAM('UGZ0006P')
COMMAREA(UGCOMMON-COMMAREA)
LENGTH(UGCOMMON-XCTL-LENGTH) END-EXEC.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
it is worthy of observation .=
because it demonstrates the
=
Appendix A – Non-UMS LXTABLE Edit Example
213
Registry of Motor Vehicles – UMS Programmer’s Manual
UMS field cascading technique,=
testing the error-code field =
and converting binary dates
=
for output. note that date
=
conversion specifies the input=
format and all other formats =
are always returned. in a
=
binary conversion the status =
will always be valid.
=
v
******* THE REST OF THIS PARAGRAPH SIMPLY FORMATS FOR THE SAMPLE
*******
DISPLAY. THE ESSENCE OF THE LOGIC IS THAT
*******
IF UGCOMMON-CURRENT-ERROR-CODE = ZERO,
*******
THE EDIT WAS PASSED AND THE CONVERTED CORE-IMAGE
*******
WAS BUILT.
*******
******* ASSUME THAT EDIT/REFORMAT MIGHT HAVE CHANGED
*******
THE MAP IMAGE:
MOVE DA-FLD005A-DATA TO M1F1.
MOVE DA-FLD005B-DATA TO M1F2.
******* CONVERT INTERNAL FIELDS TO DISPLAY IF THEY WERE INPUT
OK:
IF SAEFFDT NOT = NULL-DATE
MOVE SAEFFDT TO UGCOMMON-DATE-BINARY-FORMAT
MOVE '0' TO UGCOMMON-DATE-INPUT-FORMAT
CALL 'UICALLST' USING UGCOMMON-DATE-ROUTINE-ADDRESS
UGCOMMON-COMMAREA
MOVE UGCOMMON-DATE-GREG-DAY TO M1F1-DAY
MOVE UGCOMMON-DATE-GREG-MONTH TO M1F1-MONTH
MOVE UGCOMMON-DATE-GREG-YEAR TO M1F1-YEAR
MOVE '/' TO M1F1-DASH1, M1F1-DASH2.
IF SAEXPDT NOT = NULL-DATE
MOVE SAEXPDT TO UGCOMMON-DATE-BINARY-FORMAT
MOVE '0' TO UGCOMMON-DATE-INPUT-FORMAT
CALL 'UICALLST' USING UGCOMMON-DATE-ROUTINE-ADDRESS
UGCOMMON-COMMAREA
MOVE UGCOMMON-DATE-GREG-DAY TO M1F2-DAY
MOVE UGCOMMON-DATE-GREG-MONTH TO M1F2-MONTH
MOVE UGCOMMON-DATE-GREG-YEAR TO M1F2-YEAR
MOVE '/' TO M1F2-DASH1, M1F2-DASH2.
******* DISPLAY "OK" OR THE ERROR-CODE:
IF UGCOMMON-CURRENT-ERROR-CODE = ZERO
MOVE 'OK' TO M1F3
ELSE
MOVE 'ERROR ' TO M1F3-ERROR
MOVE UGCOMMON-CURRENT-ERROR-CODE TO M1F3-CODE.
******* PUT THE MESSAGE IN THE OUTPUT MAP
Appendix A – Non-UMS LXTABLE Edit Example
214
Registry of Motor Vehicles – UMS Programmer’s Manual
MOVE MSG1 TO MA-FLD014A-DATA.
^
===============================
1000-DO-REGNO.
*******
*******
******* PROCESS REG PREFIX, NUMBER, COLOR:
*******
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
IF MA-FLD007A-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD007B-DATA = (LOW-VALUES OR SPACES) AND
MA-FLD007C-DATA = (LOW-VALUES OR SPACES)
MOVE 'NO REGISTRATION DATA' TO MA-FLD015A-DATA
GO TO 9999-EXIT.
^
===============================
===============================
the edit services normally are=
used to process many fields at=
the same time. this technique =
edits all fields, but the ret-=
urned code is only for the 1st=
error, with the checking in
=
the order the definitions
=
occur in the template. this
=
example makes multiple passes =
to show all codes. the verbage=
documentation describes how
=
to tell which fields are in
=
error if multiple fields are =
edited at once.
=
v
******* THE NEXT 4 LINES OF CODE ARE IN ORDER FOR EACH EDITING
PASS:
MOVE LOW-VALUES TO UGCOMMON-PROGRAM-COMMAREA.
MOVE HIGH-VALUES TO UGCALLON.
MOVE ZERO TO UGCOMMON-CURRENT-ERROR-CODE,
UGCOMMON-CURRENT-MAP-LENGTH.
^
===============================
===============================
Appendix A – Non-UMS LXTABLE Edit Example
215
Registry of Motor Vehicles – UMS Programmer’s Manual
the conversion output fields =
must be set to the default
=
value for the field mode.
=
v
******* INITIALIZE INVOLVED FIELDS TO DEFAULT VALUE(S)
MOVE SPACES TO SAPREFIX, SAREGNO, SACOLOR.
^
===============================
===============================
only the fields to edit are
=
set in DUMMY-AREA. they must =
be flagged as edit candidates.=
v
******* CLEAR DUMMY-AREA, PLUG INVOLVED FIELDS:
MOVE LOW-VALUES TO DUMMY-AREA.
MOVE MA-FLD007A-DATA TO DA-FLD007A-DATA.
MOVE MA-FLD007B-DATA TO DA-FLD007B-DATA.
MOVE MA-FLD007C-DATA TO DA-FLD007C-DATA.
******* INDICATE WHICH FIELDS ARE TO BE PROCESSED:
MOVE EDIT-THIS-FIELD TO DA-FLD007A-KEY
DA-FLD007B-KEY
DA-FLD007C-KEY.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
MOVE SPACES TO MA-FLD007A-DATA, MA-FLD007B-DATA
MA-FLD007C-DATA.
^
===============================
===============================
invoke the edit process. note =
that a UGCA abend means that =
the UMS commarea was not
=
obtained properly. a UGTL
=
abend means that there is not =
a running UMS guest in the
=
region. UGTL only occurs if
=
the particular edit requires =
host download data.
=
v
Appendix A – Non-UMS LXTABLE Edit Example
216
Registry of Motor Vehicles – UMS Programmer’s Manual
******* INVOKE THE EDIT PROCESS:
EXEC CICS LINK
PROGRAM('UGZ0006P')
COMMAREA(UGCOMMON-COMMAREA)
LENGTH(UGCOMMON-XCTL-LENGTH) END-EXEC.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
it is worthy of observation .=
because it demonstrates the
=
UMS field cascading technique,=
and testing the error-code
=
field.
=
v
******* THE REST OF THIS PARAGRAPH SIMPLY FORMATS FOR THE SAMPLE
*******
DISPLAY. THE ESSENCE OF THE LOGIC IS THAT
*******
IF UGCOMMON-CURRENT-ERROR-CODE = ZERO,
*******
THE EDIT WAS PASSED
*******
AND THE CONVERTED CORE-IMAGE WAS BUILT.
*******
******* ASSUME THAT EDIT/REFORMAT MIGHT HAVE CHANGED
*******
THE MAP IMAGE:
MOVE DA-FLD007A-DATA TO M2F1-PREFIX.
MOVE DA-FLD007B-DATA TO M2F1-REGNO.
MOVE DA-FLD007C-DATA TO M2F1-COLOR.
******* CONVERT INTERNAL FIELDS TO DISPLAY IF THEY WERE INPUT
OK:
IF SAPREFIX NOT = SPACES MOVE SAPREFIX
TO M2F1-PREFIX.
IF SAREGNO NOT = SPACES MOVE SAREGNO
TO M2F1-REGNO.
IF SACOLOR NOT = SPACES MOVE SACOLOR
TO M2F1-COLOR.
******* DISPLAY "OK" OR THE ERROR-CODE:
IF UGCOMMON-CURRENT-ERROR-CODE = ZERO
MOVE 'OK' TO M2F3
ELSE
MOVE 'ERROR ' TO M2F3-ERROR
MOVE UGCOMMON-CURRENT-ERROR-CODE TO M2F3-CODE.
******* PUT THE MESSAGE IN THE OUTPUT MAP
MOVE MSG2 TO MA-FLD015A-DATA.
^
===============================
9999-EXIT.
===============================
cleanup of the common area
=
is important, in particular if=
Appendix A – Non-UMS LXTABLE Edit Example
217
Registry of Motor Vehicles – UMS Programmer’s Manual
the logic is going in some
=
resident program which hangs =
on data availability. the
=
UIGETCOM routine will return =
new areas on successive calls.=
v
EXEC CICS FREEMAIN DATA(UGCOMMON-COMMAREA) END-EXEC.
^
===============================
===============================
this code is just relative
=
to the sample program and has =
no relevance to the technique.=
v
MOVE 'A' TO MA-FLD005A-ATTR, MA-FLD005B-ATTR,
MA-FLD007A-ATTR, MA-FLD007B-ATTR,
MA-FLD007C-ATTR.
EXEC CICS SEND MAP('USAMPLE') DATAONLY NOHANDLE
FROM(MAPAREA) LENGTH(MAPLENGTH) FREEKB END-EXEC.
EXEC CICS RETURN COMMAREA(TEMP) LENGTH(4)
TRANSID(EIBTRNID) END-EXEC.
GOBACK.
^
===============================
Appendix A – Non-UMS LXTABLE Edit Example
218
Registry of Motor Vehicles – UMS Programmer’s Manual
Sample LXTABLE, Non-UMS Invocation
= editing TEMPLATE (LXTABLE) used by sample program =
============================
required:
=
v
TITLE 'USAMPLET - UMS LX SCREEN '
COPY UMSLXMAC
PUSH PRINT
PRINT OFF
COPY UGZCOMMA
POP
PRINT
ORG
UGCUSERA
^
============================
============================
conversion output fields. =
this definition must match =
the definition (format,
=
length and offset) in the =
invoking program.
=
(UMS commarea)
=
v
SAEFFDT GFLD HL2
EFFECTIVE-DATE
SAEXPDT GFLD HL2
EXPIRATION-DATE
00098400
SAPREFIX GFLD CL3
PREFIX
SAREGNO GFLD CL7
REGNO
00098600
SACOLOR GFLD CL1
COLOR
00098700
ORG
*
^
============================
============================
required, name in col-1
=
must be load-module name. =
NOMAPNA should be used for =
all non-UMS standard usage =
v
EJECT
Appendix A – Non-UMS LXTABLE Edit Example
00092000
00093000
00094000
00095000
00096000
00097000
00098100
00098300
00098500
00104400
00104500
00104600
219
Registry of Motor Vehicles – UMS Programmer’s Manual
USAMPLET UMSLXTBL TYPE=START,MAPNAME=NOMAPNA,LEVEL0=NO 00105000
^
============================
============================
date specifications. the
=
effective-date happens to =
be first, and the expire
=
date second. the editing
=
specification MUST be on
=
the last entry.
=
v
UMSLXTBL MAPFLD=FLD005A,GSAFLD=SAEFFDT
UMSLXTBL MAPFLD=FLD005B,GSAFLD=SAEXPDT,
EDIT=(PDATE,SAEFFDT,SAEXPDT)
^
============================
00110000
X00120000
00130000
============================
reg specifications. the
=
order happens to be prefix,=
regno and color. the
=
editing specification MUST =
be on the last entry.
=
v
UMSLXTBL MAPFLD=FLD007A,GSAFLD=SAPREFIX
00140000
UMSLXTBL MAPFLD=FLD007B,GSAFLD=SAREGNO
00141000
UMSLXTBL MAPFLD=FLD007C,GSAFLD=SACOLOR,
X00142000
EDIT=(REGNO,SAPREFIX,SACOLOR,SAREGNO) 00160000
EJECT
00490000
^
============================
============================
required:
=
v
UMSHEADR TYPE=DSECT
^
============================
00500000
============================
conversion input fields.
=
this definition must match =
the definition (format,
=
length and offset) in the =
invoking program.
=
(DUMMY-AREA)
=
Appendix A – Non-UMS LXTABLE Edit Example
220
Registry of Motor Vehicles – UMS Programmer’s Manual
v
DS
FLD005A
DS
FLD005B
DS
FLD007A
DS
FLD007B
DS
FLD007C
CL3
DS CL10
CL3
DS CL10
CL3
DS CL3
CL3
DS CL7
CL3
DS CL1
BMS DATA
EFFDT
BMS DATA
EXPDT
BMS DATA
PREFIX
BMS DATA
REGNO
BMS DATA
COLOR
00510000
00520000
00521000
00522000
00530000
00540000
00550000
00560000
00570000
00580000
^
============================
============================
required:
=
v
END
^
============================
01260300
Appendix A – Non-UMS LXTABLE Edit Example
221
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix A – Non-UMS LXTABLE Edit Example
222
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix B:
Guest Process Control Table
The macro prototype is included here for ease of understanding. Refer to Chapter 5 for a
discussion of the parameters. The current PTEG table is provided for illustration and
system structure documentation.
PTEG &NAME,&PGM=,&TASK=,&XLATE=,&FLAGS=,&CLEAN=,
&ALIAS=,&SCROLL=NO,&RESCROLL=NO,&UPDATE=NO,
&HOSTA=NO,&XFER=NO,&PF4=,&PF9=,&PF7AND8=NO,
&DUPKEY=,&INTERNL=NO
X
X
X
The table header and footer are shown for completeness.
UGZ0002P CSECT
NUMENT
DC
F'0'
NUMBER OF ENTRIES
DC
A(FIRST)
ADDRESS OF FIRST ENTRY
NUMXFER DC
F'0'
NUMBER OF XFER (DUPKEY) ENTRIES
DC
A(XFER1)
ADDRESS OF FIRST XFER ENTRY
NUMALIAS DC
F'0'
NUMBER OF ALIAS ENTRIES
DC
A(ALIAS1)
ADDRESS OF FIRST ALIAS ENTRY
UGZ0002Q CSECT
XFER1
EQU
*
FIRST XFER ENTRY
UGZ0002R CSECT
ALIAS1
EQU
*
FIRST ALIAS ENTRY
UGZ0002P CSECT
*
FIRST
DS
0F
.AA020
ANOP
* WARNING: NEXT ENTRY HAS UNPRINTABLES IN THE FUNCTION-CODE
* IT IS USED FOR INTERNAL INVOKATION FROM ALAR
PCTEG 'A ',PGM=UGZ0012P,TYPE=RMV
PCTEG 'ADMI',PGM=UGZ0009P,TASK=ADMI,XFER=YES,TYPE=RMV
* AUTO EXAM BOOKING 10/12/92
PCTEG 'AEB ',PGM=(UGB0213P),TYPE=RMV,INTERNL=YES,
UPDATE=YES,HOSTA=YES
PCTEG 'ALAR',PGM=UGZ0009P,TASK=ALAR,XFER=YES,TYPE=RMV
* EXAM BOOKING - DRIVING SCHOOL BLOCK BOOKING
PCTEG 'BKBB',PGM=(UGB0500P,UGB0501P),XLATE=UGB0500T,
UPDATE=YES,SCROLL=YES,HOSTA=YES
Appendix B – Guest Process Control Table
05900000
05910000
05920000
05930000
05940000
05950000
05960000
05970000
05980000
05990000
06000000
06010000
06020000
06030000
06040000
06050000
06060000
06070000
06080000
06090000
X06100000
06110000
06120000
06130000
X06140000
06150000
223
Registry of Motor Vehicles – UMS Programmer’s Manual
* EXAM BOOKING - SITE CLOSURE EXTERNAL AND INTERNAL FUNCTIONS
PCTEG 'BKCL',PGM=(UGB0410P,UGB0411P),XLATE=UGB0410T,
UPDATE=YES,SCROLL=YES,HOSTA=YES
PCTEG 'BKC1',PGM=(UGB0420P,UGB0421P),XLATE=UGB0420T,
UPDATE=YES,SCROLL=YES,HOSTA=YES,INTERNL=YES
PCTEG 'BKC2',PGM=(UGB0430P,UGB0431P),XLATE=UGB0430T,
UPDATE=YES,SCROLL=YES,HOSTA=YES,INTERNL=YES
* EXAM BOOKIING - REDESIGN - EXTERNAL AND INTERNAL FUNCTIONS
PCTEG 'BK01',PGM=(UGB0310P,UGB0311P),XLATE=UGB0310T,
SCROLL=YES,HOSTA=YES,PF4=4,PF9=4
PCTEG 'BK02',PGM=(UGB0320P,UGB0321P),XLATE=UGB0320T,
SCROLL=YES,HOSTA=YES,INTERNL=YES
PCTEG 'BK03',PGM=(UGB0330P,UGB0331P),XLATE=UGB0330T,
UPDATE=YES,HOSTA=YES,INTERNL=YES
PCTEG 'BK04',PGM=(UGB0340P,UGB0341P),XLATE=UGB0340T,
UPDATE=YES,HOSTA=YES,INTERNL=YES
* CCP- CMVI CITATION (INQ BY CITATION)
PCTEG 'CCP ',PGM=(UGC0011P,UGC0012P),XLATE=UGC0010T,
SCROLL=NO,RESCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=A045,
PF9=A045,PF7AND8=YES,NULL9=YES
* CCR - CREDIT CARD RECONCILIATION
PCTEG 'CCR ',PGM=(UGC0611P,UGC0612P),XLATE=UGC0610T,
UPDATE=YES,HOSTA=YES,NULL9=NO,PF4=012,PF9=012,
SCROLL=NO
* CIC - PAYMENT HISTORY SCROLL
PCTEG 'CIC ',PGM=(UGC1041P,UGC1042P),XLATE=UGC1040T,
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=A045,
PF9=A
PCTEG 'CJRI',PGM=(UGR1061P,UGR1062P),XLATE=UGR1060T,
HOSTA=YES,PF4=1024,PF9=1024
* COR - OBLIGATION RESOLUTION SUMMARY SCREEN
PCTEG 'COR ',PGM=(UGS1191P,UGS1192P),XLATE=UGS1190T,
UPDATE=YES,HOSTA=YES,NULL9=YES,PF4=04,PF9=045,
SCROLL=YES
* COR1 - OBLIGATION RESOLUTION DETAIL SCREEN
PCTEG 'COR1',PGM=(UGS1201P,UGS1202P),XLATE=UGS1200T,
HOSTA=YES,NULL9=YES,PF9=045,SCROLL=YES,
INTERNL=YES
*
*
*
*
*
*
06160000
X06170000
06180000
X06190000
06200000
X06210000
06220000
06230000
X06240000
06250000
X06260000
06270000
X06280000
06290000
X06300000
06310000
06320000
X06330000
X06340000
06350000
06360000
X06370000
X06380000
06390000
06400000
X06410000
X06420000
06430000
X06440000
06450000
06460000
X06470000
X06480000
06490000
06500000
X06510000
X06520000
06530000
06540000
CPB - BACKOUT TRANSACTIONS
06550000
PCTEG 'CPB ',PGM=(UGC1061P,UGC1062P),XLATE=UGC1060T,
X06560000
UPDATE=YES,PF4=1,HOSTA=YES,TYPE=RMV
06570000
06580000
CPD - RETURNED CHECK RESOLUTION
06590000
PCTEG 'CPD ',PGM=(UGC1031P,UGC1032P),XLATE=UGC1030T,
X06600000
SCROLL=NO,RESCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=V
06610000
CPG - NEW CASH SCREEN FOR FAST LANE
06620000
PCTEG 'CPG ',PGM=(UGC1051P,UGC1052P),XLATE=UGC1050T,
X06630000
UPDATE=YES,PF4=0,PF9=0,HOSTA=YES,PF7AND8=YES,TYPE=RMV
06640000
DRAD - ADDRESS ADD AND AMEND FOR SECTION V
06650000
PCTEG 'DRAD',PGM=(UGR1810P,UGR1812P),XLATE=UGR1810T,
X06660000
HOSTA=YES,TYPE=RMV
06670000
DRPL - PLATE ADD AND AMEND FOR SECTION V
06680000
PCTEG 'DRPL',PGM=(UGR1800P,UGR1802P),XLATE=UGR1800T,
X06690000
HOSTA=YES,TYPE=RMV
06700000
EXAM BOOKING 12/13/91 VERSION (SOME CDL CHANGES)
06710000
PCTEG 'EB ',PGM=(UGB0210P,UGB0211P,UGB0212P),XLATE=UGB0210T, X06720000
Appendix B – Guest Process Control Table
224
Registry of Motor Vehicles – UMS Programmer’s Manual
SCROLL=YES,UPDATE=YES,HOSTA=YES,PF4=4,PF9=4
*
* EXAM BOOKING DISTANCE CHECKOUT:
PCTEG 'EBDC',PGM=(UGB3040P,UGB3041P),XLATE=UGB3040T,
HOSTA=YES
* EXAM BOOKING LOCATION MAINTENANCE:
PCTEG 'EBLM',PGM=(UGB3020P,UGB3021P),XLATE=UGB3020T,
HOSTA=YES,UPDATE=YES
*
PCTEG 'EBO ',PGM=(UGB0010P,UGB0011P),XLATE=UGB0010T,
SCROLL=YES,UPDATE=YES,HOSTA=YES,PF4=4,PF9=4
* EXAM BOOKING OFFICE MAINTENANCE:
PCTEG 'EBOM',PGM=(UGB3060P,UGB3061P),XLATE=UGB3060T,
HOSTA=YES,UPDATE=YES
*
* EXAM BOOKING ZIP MAINTENANCE:
PCTEG 'EBZM',PGM=(UGB3000P,UGB3001P),XLATE=UGB3000T,
HOSTA=YES,UPDATE=YES
*
PCTEG 'ED ',PGM=(UGB0020P,UGB0021P,UGB0022P),XLATE=UGB0020T,
SCROLL=YES,UPDATE=YES,HOSTA=YES,PF4=4,PF9=4
* EGCO - CORRECT GRADED ROAD EXAMS
PCTEG 'EGCO',PGM=(UGB0730P,UGB0731P),XLATE=UGB0730T,
UPDATE=YES,HOSTA=YES,PF4=4,PF9=4
* EGRD - GRADE ROAD EXAMS - INDIV GRADE
PCTEG 'EGRD',PGM=(UGB0710P,UGB0711P),XLATE=UGB0710T,
SCROLL=YES,UPDATE=YES,HOSTA=YES
PCTEG 'EGRS',PGM=(UGB0720P,UGB0721P),XLATE=UGB0720T,
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=4,PF9=4
PCTEG 'EH ',PGM=(UGB0030P,UGB0031P),XLATE=UGB0030T,
SCROLL=YES,HOSTA=YES,PF4=4,PF9=4
PCTEG 'ES ',PGM=(UGB0040P,UGB0041P),XLATE=UGB0040T,
SCROLL=YES,HOSTA=YES
* ESCH - EXAMINER SCHEDULE
PCTEG 'ESCH',PGM=(UGB0700P,UGB0701P,UGB0702P),XLATE=UGB0700T,
SCROLL=YES,UPDATE=YES,HOSTA=YES
* EVRR - EVR RESEND RESPONSE SCREEN
PCTEG 'EVRR',PGM=(UGR1171P,UGR1172P),XLATE=UGR1170T,
SCROLL=NO,RESCROLL=NO,UPDATE=YES,HOSTA=YES,TYPE=RMV
*
* FOREIGN CASH POSTING
PCTEG 'FCP ',PGM=(UGC1021P,UGC1022P),XLATE=UGC1020T,
SCROLL=NO,UPDATE=NO,HOSTA=YES,PF7AND8=NO,
INTERNL=NO,NULL9=NO,PF5=NO
PCTEG 'HELP',PGM=(UGH0020P),PF7AND8=YES
PCTEG 'IMG ',PGM=(UGL0580P),XLATE=UGL0580T,
UPDATE=YES,HOSTA=YES
* IMI - INSPECTION HISTORY INQUIRY
PCTEG 'IMI ',PGM=(UGI1341P,UGI1342P),XLATE=UGI1340T,
UPDATE=YES,HOSTA=YES,PF4=01,PF9=01,PF7AND8=YES,TYPE=RMV
* IMQ - INSPECTION INQUIRY
PCTEG 'IMQ ',PGM=(UGI1321P,UGI1322P),XLATE=UGI1320T,
UPDATE=NO,HOSTA=YES,NULL9=NO,PF4=012,PF9=012,
SCROLL=NO
* IMU - INSPECTION HISTORY UPDATE
PCTEG 'IMU ',PGM=(UGI1351P,UGI1352P),XLATE=UGI1350T,
UPDATE=YES,HOSTA=YES,PF4=01,PF9=01,PF7AND8=YES,TYPE=RMV
Appendix B – Guest Process Control Table
06730000
06740000
06750000
X06760000
06770000
06780000
X06790000
06800000
06810000
X06820000
06830000
06840000
X06850000
06860000
06870000
06880000
X06890000
06900000
06910000
X06920000
06930000
06940000
X06950000
06960000
06970000
X06980000
06990000
X07000000
07010000
X07020000
07030000
X07040000
07050000
07060000
X07070000
07080000
07090000
X07100000
07110000
07120000
07130000
X07140000
X07150000
07160000
07170000
X07180000
07190000
07200000
X07210000
07220000
07230000
X07240000
X07250000
07260000
07270000
X07280000
07290000
225
Registry of Motor Vehicles – UMS Programmer’s Manual
* LICENSE ADDRESS CHANGE HISTORY: SC1298
PCTEG 'LACH',PGM=(UGL3320P,UGL3321P),XLATE=UGL3320T,
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES
* LICENSE ADDRESS INFORMATION: SC1298
PCTEG 'LAI ',PGM=(UGL3300P,UGL3301P),XLATE=UGL3300T,
PF4=4,PF9=4,HOSTA=YES
* COMMENTED OUT 6/95 UGL0310 BEING USED FOR PDPS
* LICENSE PROCESS GUIDE
TEMPORARY ONLY
PCTEG 'LCMV',PGM=(UGV0020P,UGV0021P),HOSTA=YES,PF4=4,PF9=4,
XLATE=UGV0020T,UPDATE=YES
*
PCTEG 'LG ',PGM=(UGL0310P,UGL0311P),XLATE=UGL0310T,
*
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
PCTEG 'LH ',PGM=(UGL0060P,UGL0061P,UGL0062P),HOSTA=YES,
PF4=4,PF9=4,ALIAS='ULH ',PF7AND8=YES
PCTEG 'LHMV',PGM=(UGV0030P,UGV0031P),XLATE=UGV0030T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES
PCTEG 'LI ',PGM=(UGL1070P,UGL1071P),HOSTA=YES,
PF4=4,PF9=4,XLATE=UGL1070T,ALIAS='ULI '
* COLLECT LICENSE FEES
PCTEG 'LICF',PGM=(UGL0400P,UGL0401P),XLATE=UGL0400T,
SCROLL=YES,HOSTA=YES,PF4=4,PF9=4,UPDATE=YES
* LICENSE FEES INQUIRY
PCTEG 'LIFI',PGM=(UGL0410P,UGL0411P),XLATE=UGL0410T,
SCROLL=YES,HOSTA=YES,PF4=4,PF9=4
* LICENSE ISSUE MOTORCYCLE COURSE
PCTEG 'LIMC',PGM=(UGL0700P,UGL0701P),XLATE=UGL0700T,
UPDATE=YES,SCROLL=NO,HOSTA=YES
* LICENSE FEES INQUIRY
PCTEG 'LIMV',PGM=(UGV0010P,UGV0011P),HOSTA=YES,PF4=4,PF9=4,
XLATE=UGV0010T
* EASY/FAST WAY TO ISSUE LICENSE
PCTEG 'LIQI',PGM=(UGL0050P,UGL0051P),HOSTA=YES,PF4=4,PF9=4,
PF7AND8=NO,TYPE=RMV,UPDATE=YES,XLATE=UGL0050T
* TEST DRIVER
PCTEG 'LITI',PGM=(UGL0204P,UGL0205P),XLATE=UGL0204T,
UPDATE=YES,HOSTA=YES
PCTEG 'LITT',PGM=(UGL0202P,UGL0203P),XLATE=UGL0202T,
UPDATE=YES,HOSTA=YES
PCTEG 'LIT1',PGM=(UGL0206P,UGL0207P),XLATE=UGL0206T,
UPDATE=YES,HOSTA=YES
PCTEG 'LIT2',PGM=(UGL0208P,UGL0209P),XLATE=UGL0208T,
UPDATE=YES,HOSTA=YES
PCTEG 'LIT3',PGM=(UGL0210P,UGL0211P),XLATE=UGL0210T,
UPDATE=YES,HOSTA=YES
PCTEG 'LIT4',PGM=(UGL0223P,UGL0224P),XLATE=UGL0223T,
UPDATE=YES,HOSTA=YES
PCTEG 'LIT5',PGM=(UGL0218P,UGL0219P),XLATE=UGL0218T,
UPDATE=YES,HOSTA=YES
* WARRANTS, INQUIRE FOR LICENSE
PCTEG 'LIW ',PGM=(UGN0360P,UGN0361P),XLATE=UGN0360T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES
* CANCEL LICENSE MANUFACTURE
PCTEG 'LMFC',PGM=(UGL0480P,UGL0481P),XLATE=UGL0480T,
PF4=4,PF9=4,HOSTA=YES,TYPE=RMV,UPDATE=YES
* LICENSE MANUFACTURE HISTORY
PCTEG 'LMH ',PGM=(UGL3200P,UGL3201P),XLATE=UGL3200T,
PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
Appendix B – Guest Process Control Table
07300000
X07310000
07320000
07330000
X07340000
07350000
07360000
07370000
X07380000
07390000
07400000
07410000
X07420000
07430000
X07440000
07450000
X07460000
07470000
07480000
X07490000
07500000
07510000
X07520000
07530000
07540000
X07550000
07560000
07570000
X07580000
07590000
07600000
X07610000
07620000
07630000
X07640000
07650000
X07660000
07670000
X07680000
07690000
X07700000
07710000
X07720000
07730000
X07740000
07750000
X07760000
07770000
07780000
X07790000
07800000
07810000
X07820000
07830000
07840000
X07850000
07860000
226
Registry of Motor Vehicles – UMS Programmer’s Manual
* LICENSE NUMBER SCROLL
PCTEG 'LN ',PGM=(UGL0020P,UGL0021P),HOSTA=YES,SCROLL=YES,
RESCROLL=YES,DUPKEY=LI04,ALIAS='ULN '
* OUT OF STATE LICENSE NUMBER SCROLL
PCTEG 'LNO ',PGM=(UGL0240P,UGL0241P),HOSTA=YES,SCROLL=YES,
RESCROLL=YES,DUPKEY=LD08,XLATE=UGL0240T,ALIAS='ULNO'
* SOCIAL SECURITY NUMBER SCROLL
PCTEG 'LNS ',PGM=(UGL0220P,UGL0221P),HOSTA=YES,SCROLL=YES,
RESCROLL=YES,DUPKEY=LD04,XLATE=UGL0220T,ALIAS='ULNS'
* IMAGING OOS DATA COLLECTION
PCTEG 'LOS ',PGM=(UGL0600P,UGL0601P),XLATE=UGL0600T,
UPDATE=YES,PF4=4,HOSTA=YES
* PDPS EMPLOYER/EMPLOYEE INQUIRY
PCTEG 'LPDE',PGM=(UGL0330P,UGL0331P),XLATE=UGL0330T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
* PDPS MESSAGE LOG
PCTEG 'LPDH',PGM=(UGL0310P,UGL0311P),XLATE=UGL0310T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
* PDPS ISSUE REQUEST
PCTEG 'LPDI',PGM=(UGL0320P,UGL0321P),XLATE=UGL0320T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
* PDPS MESSAGE DETAIL - PART 1
PCTEG 'LPDR',PGM=(UGL0340P,UGL0341P),XLATE=UGL0340T,
UPDATE=YES,PF4=4,PF9=4,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* PDPS MESSAGE DETAIL - PART 2
PCTEG 'LPDS',PGM=(UGL0350P,UGL0351P),XLATE=UGL0350T,
UPDATE=YES,PF4=4,PF9=4,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* JOL PASSENGER RESTRICTION MAINT
PCTEG 'LPRM',PGM=(UGL3206P,UGL3207P),XLATE=UGL3206T,
UPDATE=YES,PF4=4,PF9=4,PF7AND8=NO,HOSTA=YES,TYPE=RMV
* SSN DELETE FUNCTION
PCTEG 'LSSD',PGM=(UGL1200P,UGL1201P),XLATE=UGL1200T,
HOSTA=YES,PF4=4,PF9=4,UPDATE=YES
* SSN VERFICATION AND RESOLUTION
PCTEG 'LSSN',PGM=(UGL0870P,UGL0871P),XLATE=UGL0870T,
UPDATE=YES,HOSTA=YES,NULL9=YES,PF9=4,PF4=4,TYPE=RMV
* LICENSE TRANSACTION HISTORY
PCTEG 'LTH ',PGM=(UGL0260P,UGL0261P,UGL0262P),XLATE=UGL0260T,
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES,ALIAS='ULTH'
* LICENSE IMAGE HISTORY
PCTEG 'LTHI',PGM=(UGL0650P,UGL0651P),XLATE=UGL0650T,
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES
* LICENSE APPLY WARRANT EXEMPTION
PCTEG 'LWAX',PGM=(UGN0420P,UGN0421P),XLATE=UGN0420T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES,UPDATE=YES,TYPE=RMV
* LICENSE CANCEL WARRANT EXEMPTION
PCTEG 'LWCX',PGM=(UGN0430P,UGN0431P),XLATE=UGN0430T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES,UPDATE=YES,TYPE=RMV
* WARRANTS OFFENSE INQUIRY SCREEN
PCTEG 'LWIX',PGM=(UGN0440P,UGN0441P),XLATE=UGN0440T,
HOSTA=YES,PF4=4,PF9=4,TYPE=RMV
PCTEG 'LX ',PGM=(UGL0200P,UGL0201P),XLATE=UGL0200T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
PCTEG 'LXS ',PGM=(UGL0300P,UGL0301P),XLATE=UGL0300T,
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
* COMMENTED OUT LXV, UGL0320 USED FOR PDPS
*
PCTEG 'LXV ',PGM=(UGL0320P,UGL0321P),XLATE=UGL0320T,
Appendix B – Guest Process Control Table
07870000
X07880000
07890000
07900000
X07910000
07920000
07930000
X07940000
07950000
07960000
X07970000
07980000
07990000
X08000000
08010000
08020000
X08030000
08040000
08050000
X08060000
08070000
08080000
X08090000
08100000
08110000
X08120000
08130000
08140000
X08150000
08160000
08170000
X08180000
08190000
08200000
X08210000
08220000
08230000
X08240000
08250000
08260000
X08270000
08280000
08290000
X08300000
08310000
08320000
X08330000
08340000
08350000
X08360000
08370000
X08380000
08390000
X08400000
08410000
08420000
08430000
227
Registry of Motor Vehicles – UMS Programmer’s Manual
*
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
* CDLIS INQUIRY DETAIL
PCTEG 'LYD ',PGM=(UGL0292P,UGL0293P),XLATE=UGL0292T,
UPDATE=YES,HOSTA=YES,TYPE=RMV
* CDLIS REQUEST HISTORY
PCTEG 'LYH ',PGM=(UGL0280P,UGL0281P),XLATE=UGL0280T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
* ISSUE CDLIS REQUEST
PCTEG 'LYI ',PGM=(UGL0270P,UGL0271P),XLATE=UGL0270T,
UPDATE=YES,PF4=4,PF9=4,HOSTA=YES,TYPE=RMV
* CDLIS INQUIRY RESOLUTION
PCTEG 'LYR ',PGM=(UGL0290P,UGL0291P),XLATE=UGL0290T,
UPDATE=YES,PF4=4,PF7AND8=YES,PF9=4,HOSTA=YES,TYPE=RMV
* MATT MESSAGE DETAIL VIEWER
PCTEG 'MATD',PGM=(UGT0040P,UGT0041P),XLATE=UGT0040T,
UPDATE=YES,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* MATT TEST CASE EDITOR
PCTEG 'MATE',PGM=(UGT0010P,UGT0011P),XLATE=UGT0010T,
UPDATE=YES,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* MATT TEST CASE MANIPULATOR
PCTEG 'MATM',PGM=(UGT0020P,UGT0021P),XLATE=UGT0020T,
UPDATE=YES,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* MATT MESSAGE VIEWER
PCTEG 'MATV',PGM=(UGT0030P,UGT0031P),XLATE=UGT0030T,
UPDATE=YES,PF7AND8=YES,HOSTA=YES,TYPE=RMV
* CUT OFF THE USE OF ALARS VERSIONS OF THESE PROGRAMS BECAUSE
* OF THE NEW OUT-OF-STATE REPORTING CHANGES BEING IMPLEMENTED
PCTEG 'MDF ',PGM=(UGM0090P,UGM0091P),UPDATE=YES,
XLATE=UGM0090T,HOSTA=YES,SCROLL=YES,PF9=4
PCTEG 'MDH ',PGM=(UGM0092P,UGM0091P),UPDATE=YES,
XLATE=UGM0090T,HOSTA=YES,SCROLL=YES,PF9=4
* TRANSFER ENTRY AS REQUESTED BY DANA
PCTEG 'MIRR',PGM=UGZ0009P,TASK=MIRR,XFER=YES,TYPE=RMV
* MRB NO CREDIT PERIOD MAINTENANCE
PCTEG 'MNC ',PGM=(UGM0012P,UGM0013P),UPDATE=YES,
XLATE=UGM0012T,HOSTA=YES,SCROLL=NO,PF4=H,PF9=H
* TRANSFER ENTRY AS REQUESTED BY DANA
PCTEG 'MODL',PGM=UGZ0009P,TASK=MODL,XFER=YES,TYPE=RMV
* MRB DUPLICATE LICENSE SCROLL
PCTEG 'MRBS',PGM=(UGM0001P,UGM0002P),XLATE=UGM0001T,
HOSTA=YES,SCROLL=YES,INTERNL=YES,DUPKEY=MRBX
* MRB CUSTOMER SERVICE DETAIL INPUT
PCTEG 'MS ',PGM=(UGM0060P,UGM0061P),XLATE=UGM0060T,
HOSTA=YES,UPDATE=YES,PF4=AFEG,PF9=AFEG
* MRB CUSTOMER SERVICE SUMMARY
PCTEG 'MSC ',PGM=(UGM0066P,UGM0067P),XLATE=UGM0066T,
HOSTA=YES,SCROLL=YES,PF4=W,PF9=W
* MRB CUSTOMER SERVICE DETAIL ENTRY (2)
PCTEG 'MSP ',PGM=(UGM0064P,UGM0061P),XLATE=UGM0060T,
HOSTA=YES,UPDATE=YES,PF4=W45,PF9=W45
* MRB CUSTOMER SERVICE REFERRAL
PCTEG 'MSR ',PGM=(UGM0068P,UGM0069P),XLATE=UGM0068T,
HOSTA=YES,PF4=W,PF9=W,SCROLL=YES
* MRB CUSTOMER SERVICE DETAIL UPDATE
PCTEG 'MSU ',PGM=(UGM0062P,UGM0063P),XLATE=UGM0060T,
HOSTA=YES,UPDATE=YES,PF4=W,PF9=W
* NMVTIS DUPLICATE VIN RESOLUTION ENTRY
Appendix B – Guest Process Control Table
08440000
08450000
X08460000
08470000
08480000
X08490000
08500000
08510000
X08520000
08530000
08540000
X08550000
08560000
08570000
X08580000
08590000
08600000
X08610000
08620000
08630000
X08640000
08650000
08660000
X08670000
08680000
08690000
08700000
X08710000
08720000
X08730000
08740000
08750000
08760000
08770000
X08780000
08790000
08800000
08810000
08820000
X08830000
08840000
08870000
X08880000
08890000
08900000
X08910000
08920000
08930000
X08940000
08950000
08960000
X08970000
08980000
08990000
X09000000
09010000
09050000
228
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEG 'NMD ',PGM=(UGR1351P,UGR1352P),XLATE=UGR1350T,
UPDATE=YES,HOSTA=YES
* NMH - NMVTIS MESSAGES LOG SCREEN
PCTEG 'NMH ',PGM=(UGR1361P,UGR1362P),XLATE=UGR1360T,
UPDATE=YES,HOSTA=YES,NULL9=NO,PF4=012,PF9=012,
SCROLL=YES
* NMVTIS PROBLEM RESOLUTION SCREEN
*
PCTEG 'NMP ',PGM=(UGR1341P,UGR1342P),XLATE=UGR1340T,
UPDATE=YES,HOSTA=YES
* NEW PASSWORD (PASSWORD CHANGER)
PCTEG 'NPAS',PGM=(UGN0280P),XLATE=UGN0280T,
HOSTA=YES,UPDATE=YES
* NONRENEW, GENERAL ADDRESS EDIT
PCTEG 'NRAE',PGM=(UGN0320P,UGN0321P,UGN0322P),XLATE=UGN0320T,
HOSTA=YES,PF4=4,PF9=4,AEDNEW=NO
* NONRENEW, GENERAL ADDRESS EDIT / 40 BYTE
PCTEG 'NRBE',PGM=(UGN0340P,UGN0341P,UGN0342P),XLATE=UGN0340T,
HOSTA=YES,PF4=4,PF9=4,AEDNEW=NO
* NONRENEW, CLEAR TICKET/BILL
PCTEG 'NRC ',PGM=(UGN0120P,UGN0121P),XLATE=UGN0120T,
HOSTA=YES,UPDATE=YES
* NONRENEW, DISPLAY TICKET CLEAR HISTORY BY CLERK
PCTEG 'NRKH',PGM=(UGN0240P,UGN0241P),XLATE=UGN0240T,
HOSTA=YES,SCROLL=YES,RESCROLL=YES
* NONRENEW, INQUIRE FOR LICENSE
PCTEG 'NRL ',PGM=(UGN0040P,UGN0041P),XLATE=UGN0040T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES
* NONRENEW, DISPLAY TICKET CLEAR HISTORY BY LICENSE
PCTEG 'NRLH',PGM=(UGN0180P,UGN0181P),XLATE=UGN0180T,
HOSTA=YES,PF4=4,PF9=4,PF7AND8=YES
* NONRENEW, MARK
PCTEG 'NRM ',PGM=(UGN0080P,UGN0081P),XLATE=UGN0080T,
HOSTA=YES,PF4=0,PF9=0,UPDATE=YES
* NONRENEW, MARK EXTERNAL (PERS ONLY)
PCTEG 'NRMX',PGM=(UGN0300P,UGN0301P),XLATE=UGN0300T,
HOSTA=YES,PF4=4,PF9=4,UPDATE=YES
* NONRENEW, INQUIRE FOR REGISTRATION
PCTEG 'NRR ',PGM=(UGN0020P,UGN0021P),XLATE=UGN0020T,
HOSTA=YES,PF4=0,PF9=0,PF7AND8=YES
* NONRENEW, DISPLAY TICKET CLEAR HISTORY BY REGISTRATION
PCTEG 'NRRH',PGM=(UGN0200P,UGN0201P),XLATE=UGN0200T,
HOSTA=YES,PF4=0,PF9=0,PF7AND8=YES
* NONRENEW, DISPLAY SURROGATE AND OWNER FOR REG
PCTEG 'NRRS',PGM=(UGN0460P,UGN0461P),XLATE=UGN0460T,
HOSTA=YES,PF4=0,PF9=0
* NONRENEW, DISPLAY SWAP TARGET
PCTEG 'NRS ',PGM=(UGN0100P,UGN0101P),XLATE=UGN0100T,
HOSTA=YES,PF4=04,PF9=04,UPDATE=YES
* NONRENEW, INQUIRE FOR TICKET/BILL
PCTEG 'NRT ',PGM=(UGN0060P,UGN0061P),XLATE=UGN0060T,
HOSTA=YES
* NONRENEW, DISPLAY TICKET CLEAR HISTORY BY TICKET/BILL
PCTEG 'NRTH',PGM=(UGN0220P,UGN0221P),XLATE=UGN0220T,
HOSTA=YES,SCROLL=YES,RESCROLL=YES
* NONRENEW, CHANGE TICKET/BILL NUMBER
PCTEG 'NRX ',PGM=(UGN0160P,UGN0161P),XLATE=UGN0160T,
Appendix B – Guest Process Control Table
X09070000
09080000
09100000
X09110000
X09120000
09130000
09150000
09160000
X09170000
09180000
09190000
X09200000
09210000
09220000
X09230000
09240000
09250000
X09260000
09270000
09280000
X09290000
09300000
09310000
X09320000
09330000
09340000
X09350000
09360000
09370000
X09380000
09390000
09400000
X09410000
09420000
09430000
X09440000
09450000
09460000
X09470000
09480000
09490000
X09500000
09510000
09520000
X09530000
09540000
09550000
X09560000
09570000
09580000
X09590000
09600000
09610000
X09620000
09630000
09640000
X09650000
229
Registry of Motor Vehicles – UMS Programmer’s Manual
HOSTA=YES,UPDATE=YES
* NONRENEW, CLEAR ALL TICKET/BILL IN TOWN
PCTEG 'NRZ ',PGM=(UGN0140P,UGN0141P),XLATE=UGN0140T,
HOSTA=YES,UPDATE=YES,PF4=04,PF9=04
* NONRENEW, LOOKUP ZIPCODE FOR MASS TOWN/SUBURB
PCTEG 'NZIP',PGM=UGN0260P,XLATE=UGN0260T
* OVERWEIGHT REDUCIBLE PERMIT ISSUANCE SCREEN
PCTEG 'OW ',PGM=(UGW1111P,UGW1112P),XLATE=UGW1110T,
UPDATE=YES,PF4=01E,PF9=01E,HOSTA=YES,TYPE=RMV
09660000
09670000
X09680000
09690000
09700000
09710000
09720000
X09730000
09740000
09750000
* OWH - OVERWEIGHT HISTORY
09760000
PCTEG 'OWH ',PGM=(UGW1131P,UGW1132P),XLATE=UGW1130T,
X09770000
HOSTA=YES,PF4=E01,PF9=01,SCROLL=YES,TYPE=RMV
09780000
09790000
* OWI - OVERWEIGHT INQUIRY
09800000
PCTEG 'OWI ',PGM=(UGW1141P,UGW1142P),XLATE=UGW1140T,
X09810000
HOSTA=YES,PF4=E01,PF9=01,TYPE=RMV
09820000
09830000
* TRANSFER ENTRY AS REQUESTED BY DANA
09840000
PCTEG 'PROD',PGM=UGZ0009P,TASK=PROD,XFER=YES,TYPE=RMV
09850000
PCTEG 'RA ',PGM=(UGR1271P,UGR1272P),XLATE=UGR1270T,
X09870000
UPDATE=YES,HOSTA=YES,PF4=01,PF9=014,NULL9=YES,
X09880000
TYPE=RMV,TASK=UG05
09890000
* RBS - REGISTRATION BANK SCROLL
09900000
PCTEG 'RBS ',PGM=(UGR2201P,UGR2202P),XLATE=UGR2200T,
X09910000
SCROLL=YES,RESCROLL=YES,HOSTA=YES,ALIAS='URBS'
09920000
* REGISTRATION HISTORY
09930000
PCTEG 'RH ',PGM=(UGR1251P,UGR1252P),XLATE=UGR1250T,
X09940000
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=01
09950000
PCTEG 'RI ',PGM=(UGR5061P,UGR5062P),XLATE=UGR5060T,
X09960000
HOSTA=YES,PF4=1024,PF9=1024,ALIAS='URI '
09970000
PCTEG 'RI2 ',PGM=(UGR2061P,UGR2062P),XLATE=UGR2060T,
X09980000
HOSTA=YES,PF4=1024,PF9=1024
09990000
PCTEG 'RI3 ',PGM=(UGR3061P,UGR3062P),XLATE=UGR3060T,
X10000000
HOSTA=YES,PF4=1024,PF9=1024
10010000
*
PCTEG 'RI5 ',PGM=(UGR5061P,UGR5062P),XLATE=UGR5060T,
10020000
*
HOSTA=YES,PF4=1024,PF9=1024
10030000
PCTEG 'RI6 ',PGM=(UGR6061P,UGR6062P),XLATE=UGR6060T,
X10040000
HOSTA=YES,PF4=1024,PF9=1024
10050000
PCTEG 'RLC ',PGM=(UGR1070P,UGR1071P),XLATE=UGR1070T,
X10060000
UPDATE=YES,PF4=012,PF9=012,HOSTA=YES
10070000
PCTEG 'RMAN',PGM=(UGL0581P),XLATE=UGL0580T,
X10080000
UPDATE=YES,HOSTA=YES
10090000
*********************************************************************** 10120000
*
PCTEG 'RNF ',PGM=(UGR1231P,UGR1232P),XLATE=UGR1230T,
10130000
*
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF9=05,PF4=05
10140000
*
PCTEG 'RNF ',PGM=(UGR1231P,UGR1232P),XLATE=UGR1230T,
10150000
*
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF9=5,PF4=5
10160000
PCTEG 'RNF ',PGM=(UGR1231P,UGR1232P),XLATE=UGR1230T,
X10170000
SCROLL=YES,RESCROLL=YES,DUPKEY=UR09,HOSTA=YES,PF9=5
10180000
*********************************************************************** 10190000
* RP - VANITY/SPECIAL PLATE ORDER
10220000
PCTEG 'RP ',PGM=(UGR0311P,UGR0312P),XLATE=UGR0310T,
X10230000
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=,PF9=045,
X10240000
NULL9=YES,TYPE=RMV
10250000
*
10260000
* REG SUPERQUERY.
10270000
Appendix B – Guest Process Control Table
230
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEG 'RSQ ',PGM=(UGR0020P,UGR0021P),HOSTA=YES,SCROLL=YES,
RESCROLL=YES,XLATE=UGR0020T
X10280000
10290000
PCTEG 'RVN ',PGM=(UGR2141P,UGR2142P),XLATE=UGR2140T,
UPDATE=YES,PF4=01,PF9=01,HOSTA=YES,ALIAS='URVN'
X10330000
10340000
10320000
10370000
*
PCTEG 'R1A ',PGM=(UGR1181P,UGR1182P),XLATE=UGR1180T,
PCTEG 'R1A ',PGM=(UGR2181P,UGR2182P),XLATE=UGR2180T,
SCROLL=NO,UPDATE=YES,PF9=0145,HOSTA=YES,NULL9=YES,
TASK=UG05
*
PCTEG 'R1B ',PGM=(UGR1191P,UGR1192P),XLATE=UGR1190T,
PCTEG 'R1B ',PGM=(UGR2191P,UGR2192P),XLATE=UGR2190T,
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF7AND8=NO,INTERNL=YES,
NULL9=YES,PF9=L,PF5=YES,TASK=UG05
*
NULL9=NO,PF9=L,PF5=YES
* R1C - IN CUSTODY LESSEE INFORMATION
PCTEG 'R1C ',PGM=(UGR2301P,UGR2302P),XLATE=UGR2300T,
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=0,PF9=045,
NULL9=YES,TASK=UG05
PCTEG 'SDH ',PGM=(UGS1101P,UGS1102P),XLATE=UGS1100T,
PF4=4,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
10380000
X10390000
X10400000
10410000
10450000
X10460000
X10470000
10480000
10490000
10530000
X10540000
X10550000
10560000
X10570000
10580000
PCTEG 'SH ',PGM=(UGS3051P,UGS3052P),HOSTA=YES,SCROLL=YES,
PF4=04,PF9=04,ALIAS='USH '
PCTEG 'SH1 ',PGM=(UGS0100P,UGS0101P),HOSTA=YES,PF7AND8=YES,
PF4=4,PF9=4,TYPE=RMV
PCTEG 'SH2 ',PGM=(UGS1051P,UGS1052P),HOSTA=YES,PF7AND8=YES,
PF4=4,PF9=4,TYPE=RMV
PCTEG 'SOA ',PGM=(UGS1171P,UGS1172P),XLATE=UGS1170T,
UPDATE=YES,PF4=74,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
PCTEG 'SOC ',PGM=(UGS3151P,UGS3152P),XLATE=UGS3150T,
UPDATE=YES,PF4=84,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
PCTEG 'SOC1',PGM=(UGS1151P,UGS1152P),XLATE=UGS1150T,
UPDATE=YES,PF4=84,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
PCTEG 'SOW ',PGM=(UGS1161P,UGS1162P),XLATE=UGS1160T,
UPDATE=YES,PF4=94,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
* TRANSFER ENTRY AS REQUESTED BY DANA
PCTEG 'SPCL',PGM=UGZ0009P,TASK=SPCL,XFER=YES,TYPE=RMV
PCTEG 'STAT',PGM=UGZ0010P,HOSTA=NO,
FLAGS=FF00000000000000
PCTEG 'SYSM',PGM=UGZ0009P,TASK=SYSM,XFER=YES,TYPE=RMV
* TAS - TITLE AUDIT SCREEN
PCTEG 'TAS ',PGM=(UGR1081P,UGR1082P),XLATE=UGR1080T,
UPDATE=YES,HOSTA=YES,NULL9=NO,PF7AND8=YES
* TRANSFER ENTRY
PCTEG 'TEST',PGM=UGZ0009P,TASK=TEST,XFER=YES,TYPE=RMV
*
*
*
*
PREVIOUS RELEASE
*
PCTEG 'TLI ',PGM=(UGL0070P,UGL0071P),HOSTA=YES,PF4=4,PF9=4
PCTEG 'TPA ',PGM=(UGU2121P,UGU2122P),XLATE=UGU2120T,
UPDATE=YES,PF4=6,PF9=0146,HOSTA=YES
PCTEG 'TPH ',PGM=(UGU2041P,UGU2042P),XLATE=UGU2040T,
HOSTA=YES,PF9=4,PF7AND8=YES,PF4=4
PCTEG 'TPIC',PGM=(UGU3021P,UGU3022P),XLATE=UGU3020T,
X10630000
10640000
X10680000
10690000
X10700000
10710000
X10720000
10730000
X10750000
10760000
X10780000
10790000
X10800000
10810000
10820000
10830000
X10840000
10850000
10860000
10870000
X10880000
10890000
10900000
10910000
10920000
10930000
10940000
10950000
10960000
10970000
X10980000
10990000
X11000000
11010000
X11020000
Appendix B – Guest Process Control Table
231
Registry of Motor Vehicles – UMS Programmer’s Manual
UPDATE=YES,PF9=01,HOSTA=YES,SCROLL=YES,INTERNL=YES
PCTEG 'TPOI',PGM=(UGU2011P,UGU2012P),XLATE=UGU2010T,
HOSTA=YES,PF9=4
PCTEG 'TPTH',PGM=(UGU1131P,UGU1132P),XLATE=UGU1130T,
HOSTA=YES,PF9=6,PF7AND8=YES,PF4=6
* TRBS - REGISTRATION BANK SCROLL
PCTEG 'TRBS',PGM=(UGR1201P,UGR1202P),XLATE=UGR1200T,
SCROLL=YES,RESCROLL=YES,HOSTA=YES
PCTEG 'TRI ',PGM=(UGR4061P,UGR4062P),XLATE=UGR4060T,
HOSTA=YES,PF4=1024,PF9=1024
PCTEG 'TRSN',PGM=(UGRI102P,UGRO102P),XLATE=UGRX102T,
SCROLL=YES,RESCROLL=YES,HOSTA=YES
PCTEG 'TRSR',PGM=(UGRI100P,UGRO100P),XLATE=UGRX100T,
SCROLL=YES,RESCROLL=YES,DUPKEY=UR02,HOSTA=YES
PCTEG 'TR1A',PGM=(UGR1181P,UGR1182P),XLATE=UGR1180T,
SCROLL=NO,UPDATE=YES,PF9=0145,HOSTA=YES,NULL9=YES
PCTEG 'TR1B',PGM=(UGR1191P,UGR1192P),XLATE=UGR1190T,
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF7AND8=NO,INTERNL=YES,
NULL9=YES,PF9=L,PF5=YES
PCTEG 'TSH ',PGM=(UGS2051P,UGS2052P),HOSTA=YES,SCROLL=YES,
PF4=4,PF9=4
* TRANSFER ENTRY
*********PCTEG 'TSO ',PGM=UGZ0009P,TASK=TSO,XFER=YES,TYPE=RMV
PCTEG 'TSO ',PGM=UGZ0009P,TASK=E3E2D640,XFER=YES,TYPE=RMV
11030000
X11040000
11050000
X11060000
11070000
11080000
X11090000
11100000
X11110000
11120000
X11130000
11140000
X11150000
11160000
X11170000
11180000
X11190000
X11200000
11210000
X11220000
11230000
11240000
11250000
11260000
PCTEG 'TSOC',PGM=(UGS2151P,UGS2152P),XLATE=UGS2150T,
UPDATE=YES,PF4=84,PF9=4,HOSTA=YES,PF7AND8=YES,TYPE=RMV
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
X11300000
11310000
11340000
PCTEG 'TVH ',PGM=(UGU2111P,UGU2112P),XLATE=UGU2110T,
X11350000
HOSTA=YES,PF7AND8=YES,PF4=01,PF9=01
11360000
OLD RVN ENTRY
11370000
PCTEG 'TVN ',PGM=(UGR1141P,UGR1142P),XLATE=UGR1140T,
X11380000
UPDATE=YES,PF4=01,PF9=01,HOSTA=YES,ALIAS='UTVN'
11390000
OLD VT PCTEG ENTRY
11400000
PCTEG 'TVT ',PGM=(UGR2261P,UGR2262P),XLATE=UGR2260T,
X11410000
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=1,PF9=1
CP1294 11420000
OLD VT PCTEG ENTRY
CP1294 11430000
PCTEG 'TVT1',PGM=(UGR1261P,UGR1262P),XLATE=UGR1260T,
CP1294X11440000
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=1,PF9=1
CP1294 11450000
TXH - PAYMENT HISTORY SCROLL
CP0695 11460000
PCTEG 'TXH ',PGM=(UGR1281P,UGR1282P),XLATE=UGR1280T,
CP0695X11470000
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=02
CP0695 11480000
11490000
11500000
CHANGES FOR EDS 11/13/92 DEB V.
11510000
11520000
PCTEG 'T1A ',PGM=(UGR1211P,UGR1212P),XLATE=UGR1210T,
X 11530000
UPDATE=YES,HOSTA=YES,PF4=012,PF9=01L,NULL9=YES,TYPE=RMV 11540000
PCTEG 'T1A ',PGM=(UGR1211P,UGR1212P),XLATE=UGR1210T,
X11550000
UPDATE=YES,HOSTA=YES,PF4=210,PF9=01L,NULL9=YES,TYPE=RMV 11560000
11570000
END OF 11/13/92 CHANGE
11580000
11590000
PCTEG 'T1B ',PGM=(UGR1221P,UGR1222P),XLATE=UGR1220T,
X11600000
UPDATE=YES,HOSTA=YES,INTERNL=YES,TYPE=RMV
11610000
11620000
END OF ADDITIONS FOR EDS
11630000
Appendix B – Guest Process Control Table
232
Registry of Motor Vehicles – UMS Programmer’s Manual
*
11640000
* T1C - ALTERNATE ADDRESS GUEST PROGRAMS CP1098
11650000
PCTEG 'T1C ',PGM=(UGR1311P,UGR1312P),XLATE=UGR1310T,
X11660000
SCROLL=NO,UPDATE=YES,HOSTA=YES,PF4=012,PF9=01,
X11670000
NULL9=YES
11680000
*
11690000
*
PREV
11700000
*
11710000
* IMAGING DUPLICATE LICENSE OR MASS ID OR LIQUOR ID
11720000
PCTEG 'UDUP',PGM=(UGL0640P,UGL0641P),XLATE=UGL0640T,
X11730000
PF4=4,HOSTA=YES,UPDATE=YES
11740000
PCTEG 'UHMT',PGM=UGZ0009P,TASK=UHMT,XFER=YES,TYPE=RMV
11750000
PCTEG 'UL ',PGM=UGZ0010P,HOSTA=NO
11760000
* IMAGING CUSTOMER ADD SCREEN
11770000
PCTEG 'ULC ',PGM=(UGL0540P,UGL0541P),XLATE=UGL0540T,
X11780000
UPDATE=YES,HOSTA=YES,NULL9=YES,PF9=4,PF4=4,
X11790000
ALIAS='LC '
11800000
* IMAGING CUSTOMER ADD SCREEN
11810000
PCTEG 'ULCA',PGM=(UGL0560P,UGL0561P),XLATE=UGL0560T,
X11820000
UPDATE=YES,HOSTA=YES,NULL9=YES,PF9=0
11830000
*
11860000
PCTEG 'ULP ',PGM=(UGL0030P,UGL0031P),HOSTA=YES,SCROLL=YES,
X11870000
RESCROLL=YES,DUPKEY=LI03,ALIAS='LP '
11880000
*
11890000
* MRB AT-FAULT CLAIM INQUIRY
11920000
PCTEG 'UMA ',PGM=(UGM0030P,UGM0031P),XLATE=UGM0030T,
X11930000
HOSTA=YES,PF4=F,PF9=F4,UPDATE=YES,PF7AND8=YES,
X11940000
ALIAS='MA '
11950000
* MRB BATCH CONTROL ENTRY
11960000
PCTEG 'UMB ',PGM=(UGM0150P,UGM0151P),UPDATE=YES,
X11970000
XLATE=UGM0150T,HOSTA=YES,SCROLL=YES
11980000
* MRB BOARD OF APPEALS REVERSAL
11990000
PCTEG 'UMBA',PGM=(UGM0032P,UGM0033P),XLATE=UGM0032T,ALIAS='MBA ', X12000000
HOSTA=YES,PF4=F,PF9=F4,UPDATE=YES,PF7AND8=YES
12010000
* MRB PENDING BATCH REVIEW
12020000
PCTEG 'UMBP',PGM=(UGM0152P,UGM0153P),UPDATE=NO,
X12030000
XLATE=UGM0152T,HOSTA=YES,SCROLL=YES
12040000
* MRB COMPREHENSIVE CLAIM INQUIRY
12050000
PCTEG 'UMC ',PGM=(UGM0040P,UGM0041P),XLATE=UGM0040T,
X12060000
HOSTA=YES,PF4=G,PF9=G4,UPDATE=YES,PF7AND8=YES,
X12070000
ALIAS='MC '
12080000
* MRB ADMINISTRATIVE DETAIL
12090000
PCTEG 'UMDD',PGM=(UGM0094P,UGM0095P),UPDATE=NO,
X12100000
XLATE=UGM0094T,HOSTA=YES,SCROLL=NO,PF4=4,
X12110000
ALIAS='MDD '
12120000
* MRB DRIVING HISTORY
12140000
*
PCTEG 'UMDF',PGM=(UGM0090P,UGM0091P),UPDATE=YES,
X 12150000
*
XLATE=UGM0090T,HOSTA=YES,SCROLL=YES,PF9=4
12160000
*
PCTEG 'UMDH',PGM=(UGM0092P,UGM0091P),UPDATE=YES,
X 12170000
*
XLATE=UGM0090T,HOSTA=YES,SCROLL=YES,PF9=4
12180000
* MRB SDIP INQUIRY MENU
12190000
PCTEG 'UMI ',PGM=(UGM0022P),XLATE=UGM0022T,HOSTA=NO
12200000
12210000
* MRB SDIP INQUIRY OUTPUT SCREEN
12220000
PCTEG 'UMIQ',PGM=(UGM0021P),XLATE=UGM0021T,HOSTA=YES,
X12230000
PF7AND8=YES,INTERNL=YES,UPDATE=YES
12240000
* MRB SDIP INQUIRY NEW POLICY
12250000
Appendix B – Guest Process Control Table
233
Registry of Motor Vehicles – UMS Programmer’s Manual
* MRB
* MRB
* MRB
* MRB
* MRB
* MRB
PCTEG 'UMI1',PGM=(UGM0023P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY POLICY RENEWAL
PCTEG 'UMI2',PGM=(UGM0024P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY ADD OPERATOR
PCTEG 'UMI3',PGM=(UGM0025P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY ADD COLLISION
PCTEG 'UMI4',PGM=(UGM0026P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY ADD LIABILITY
PCTEG 'UMI5',PGM=(UGM0027P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY REINSTATEMENT
PCTEG 'UMI6',PGM=(UGM0028P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,UPDATE=YES,PF4=E4,PF9=E4
SDIP INQUIRY OPERATOR INPUT SCREEN
PCTEG 'UMI9',PGM=(UGM0020P,UGM0029P),XLATE=UGM0020T,
HOSTA=YES,PF4=E4,PF9=E4,ALIAS='MI9 '
*
* MRB LATE APPEAL GENERATION
PCTEG 'UMLA',PGM=(UGM0080P,UGM0081P),XLATE=UGM0080T,
HOSTA=YES,UPDATE=YES,PF4=F,PF9=F,ALIAS='MLA '
PCTEG 'UMM ',PGM=UGZ0010P,HOSTA=NO
* MRB OPERATOR SUMMARY DISPLAY
PCTEG 'UMO ',PGM=(UGM0010P,UGM0011P),XLATE=UGM0010T,
HOSTA=YES,SCROLL=YES,PF4=45,PF9=45,ALIAS='MO '
* MRB NOWN SUMMARY DISPLAY
PCTEG 'UMON',PGM=(UGM0070P,UGM0071P),XLATE=UGM0070T,
HOSTA=YES,SCROLL=YES,PF4=5,PF9=5,ALIAS='MON '
* MRB ADD CITATION
PCTEG 'UMV ',PGM=(UGM0250P,UGM0251P),XLATE=UGM0051T,
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
* MRB ADD CITATION
PCTEG 'UMVH',PGM=(UGM0052P,UGM0053P),XLATE=UGM0052T,
HOSTA=YES,PF4=A,PF9=A,SCROLL=YES,ALIAS='MVH '
* MRB CITATION INQUIRY
PCTEG 'UMVI',PGM=(UGM0050P,UGM0051P),XLATE=UGM0050T,
HOSTA=YES,PF4=A,PF9=A,ALIAS='MVI '
* MRB DUPLICATE CITATION SCROLL
PCTEG 'UMVS',PGM=(UGM0055P,UGM0056P),XLATE=UGM0055T,
HOSTA=YES,SCROLL=YES,INTERNL=YES,DUPKEY=UMVX
* MRB SUSPENDED CITATIONS
PCTEG 'UMVU',PGM=(UGM0252P,UGM0253P),XLATE=UGM0051T,
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
* MRB CITATIONS - MODIFY VIOLATOR INFORMATON
PCTEG 'UMV1',PGM=(UGM0254P,UGM0255P),XLATE=UGM0051T,
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
* MRB CITATIONS - MODIFY VIOLATION INFORMATION
PCTEG 'UMV2',PGM=(UGM0256P,UGM0257P),XLATE=UGM0051T,
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
* MRB CITATIONS - REVERSAL
PCTEG 'UMV3',PGM=(UGM0258P,UGM0259P),XLATE=UGM0051T,
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
* MRB CITATIONS - MODIFY POLICE/LOCATION INFORMATION
PCTEG 'UMV4',PGM=(UGM0260P,UGM0261P),XLATE=UGM0051T,
Appendix B – Guest Process Control Table
X12260000
12270000
12280000
X12290000
12300000
12310000
X12320000
12330000
12340000
X12350000
12360000
12370000
X12380000
12390000
12400000
X12410000
12420000
12430000
X12440000
12450000
12460000
12470000
X12480000
12490000
12500000
12510000
X12520000
12530000
12540000
X12550000
12560000
12570000
X12580000
12590000
12600000
X12610000
12620000
12630000
X12640000
12650000
12660000
X12670000
12680000
12690000
X12700000
12710000
12720000
X12730000
12740000
12750000
X12760000
12770000
12780000
X12790000
12800000
12810000
X12820000
234
Registry of Motor Vehicles – UMS Programmer’s Manual
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12830000
* MRB CITATIONS - REINSTATE
12840000
PCTEG 'UMV5',PGM=(UGM0262P,UGM0263P),XLATE=UGM0051T,
X12850000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12860000
* MRB CITATIONS - NULL PROCESS
12870000
PCTEG 'UMV6',PGM=(UGM0264P,UGM0265P),XLATE=UGM0051T,
X12880000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12890000
* MRB CITATIONS - HEARING REQUEST
12900000
PCTEG 'UMV7',PGM=(UGM0266P,UGM0267P),XLATE=UGM0051T,
X12910000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12920000
* MRB CITATIONS - COURT RESPONSE TO ORIGINAL HEARING
12930000
PCTEG 'UMV8',PGM=(UGM0272P,UGM0273P),XLATE=UGM0051T,
X12940000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12950000
* MRB CITATIONS - CHANGE CITATION NUMBER
12960000
PCTEG 'UMV9',PGM=(UGM0276P,UGM0277P),XLATE=UGM0051T,
X12970000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
12980000
* MRB CITATIONS - CHANGE HEARING REQUEST
12990000
PCTEG 'UM7C',PGM=(UGM0269P,UGM0267P),XLATE=UGM0051T,
X13000000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
13010000
* MRB CITATIONS - LATE HEARING REQUEST
13020000
PCTEG 'UM7L',PGM=(UGM0268P,UGM0267P),XLATE=UGM0051T,
X13030000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
13040000
* MRB CITATIONS - NULL HEARING REQUEST
13050000
PCTEG 'UM7N',PGM=(UGM0270P,UGM0267P),XLATE=UGM0051T,
X13060000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
13070000
* MRB CITATIONS - COURT RESPONSE TO CHANGED HEARING
13080000
PCTEG 'UM8L',PGM=(UGM0274P,UGM0273P),XLATE=UGM0051T,
X13090000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
13100000
* MRB CITATIONS - NULL COURT RESPONSE
13110000
PCTEG 'UM8N',PGM=(UGM0275P,UGM0273P),XLATE=UGM0051T,
X13120000
HOSTA=YES,PF4=A,PF9=A,UPDATE=YES
13130000
*
13140000
PCTEG 'UP ',PGM=UGZ0010P,HOSTA=NO
13150000
PCTEG 'UPA ',PGM=(UGU3121P,UGU3122P),XLATE=UGU3120T,
X13160000
UPDATE=YES,PF4=6,PF9=456,HOSTA=YES
13170000
PCTEG 'UPH ',PGM=(UGU3041P,UGU3042P),XLATE=UGU3040T,
X13180000
HOSTA=YES,PF9=45,SCROLL=YES,PF4=45
13190000
PCTEG 'UPIC',PGM=(UGU4021P,UGU4022P),XLATE=UGU4020T,
X13200000
UPDATE=YES,PF9=01,HOSTA=YES,SCROLL=YES,INTERNL=YES
13210000
* UPMV - MULTIPLE VEHICLE AMEND SCREEN
13220000
PCTEG 'UPMV',PGM=(UGU1141P,UGU1142P),XLATE=UGU1140T,
X13230000
SCROLL=YES,UPDATE=YES,HOSTA=YES,PF4=6,PF9=01
13240000
PCTEG 'UPOI',PGM=(UGU3011P,UGU3012P),XLATE=UGU3010T,
X13250000
HOSTA=YES,PF9=45
13260000
PCTEG 'UPTH',PGM=(UGU2131P,UGU2132P),XLATE=UGU2130T,
X13270000
HOSTA=YES,PF9=6,PF7AND8=YES,PF4=6
13280000
PCTEG 'UR ',PGM=UGZ0010P,HOSTA=NO
13290000
*
PCTEG 'URBS',PGM=(UGR1201P,UGR1202P),XLATE=UGR1200T,
X 13340000
*
SCROLL=YES,RESCROLL=YES,HOSTA=YES,DUPKEY=BS01
13350000
*
PCTEG 'URBS',PGM=(UGR1201P,UGR1202P),XLATE=UGR1200T,
X 13390000
*
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF9=L,PF4=L,
X 13400000
*
DUPKEY=BS01
13410000
*
PCTEG 'URBS',PGM=(UGR1201P,UGR1202P),XLATE=UGR1200T,
X 13450000
*
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF9=L,PF4=L
13460000
PCTEG 'URN ',PGM=(UGR0010P,UGR0011P),HOSTA=YES,SCROLL=YES,
X13500000
RESCROLL=YES
13510000
PCTEG 'URSN',PGM=(UGR1091P,UGR1092P),XLATE=UGR1090T,
X13520000
Appendix B – Guest Process Control Table
235
Registry of Motor Vehicles – UMS Programmer’s Manual
SCROLL=YES,RESCROLL=YES,HOSTA=YES
PCTEG 'URSR',PGM=(UGR1241P,UGR1242P),XLATE=UGR1240T,
SCROLL=YES,RESCROLL=YES,DUPKEY=UR05,HOSTA=YES
PCTEG 'URSV',PGM=(UGRI101P,UGRO101P),XLATE=UGRX101T,
SCROLL=YES,RESCROLL=YES,DUPKEY=UR03,HOSTA=YES
*
PCTEG 'URVN',PGM=(UGR1141P,UGR1142P),XLATE=UGR1140T,
*
UPDATE=YES,PF4=01,PF9=01,HOSTA=YES
*
PCTEG 'USH ',PGM=(UGS2051P,UGS2052P),HOSTA=YES,SCROLL=YES,
*
PF4=04,PF9=04,TYPE=RMV,ALIAS='SH '
PCTEG 'UVH ',PGM=(UGU3111P,UGU3112P),XLATE=UGU3110T,
HOSTA=YES,SCROLL=YES,PF4=01,PF9=01
PCTEG 'VER ',PGM=UGZ0032P,HOSTA=NO
* NEW VT PCTEG ENTRY
PCTEG 'VT ',PGM=(UGR3261P,UGR3262P),XLATE=UGR3260T,
SCROLL=YES,RESCROLL=YES,HOSTA=YES,PF4=1,PF9=1
* NEW ZLEB ENTRY FOR IMAGING
PCTEG 'ZLEB',PGM=(UGL0040P)
* NEW ZL01 ENTRY FOR IMAGING
PCTEG 'ZL01',PGM=(UGL0500P),XLATE=UGL0500T,
PF4=4,PF9=4,NULL9=YES
* NEW ZN01 ENTRY FOR IMAGING
PCTEG 'ZN01',PGM=(UGL0510P),XLATE=UGL0510T,
PF4=5,PF9=5,NULL9=YES
AIF
('&MODEFLG' EQ 'P').AA040
LAST
DC
XL4'FFFFFFFF'
UGZ0002Q CSECT
XFER2
EQU
*
FIRST XFER ENTRY
Appendix B – Guest Process Control Table
13530000
X13540000
13550000
X13560000
13570000
X 13610000
13620000
13690000
13700000
X13770000
13780000
13830000
13840000
X13850000
13860000
13870000
13880000
13890000
X13900000
13910000
13920000
X13930000
13940000
13950000
13960000
13970000
13980000
236
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix C:
Host Process Control Table
The prototype of the macro is repeated here for convenience of reference. For a
discussion of the parameters, please turn to Chapter 5.
PCTEH &NAME,&PGM=,&TASK=,&RMV=,&FLAGS=,&CLEAN=,
&DUPKEY=,&SERVICE=
NOTE: SPECIFICATION OF A NONEXISTANT ENTRY WILL RESULT IN
UNDEFINED SYMBOLS OF THE FORM BTC$XXXX WHERE
XXXX IS THE BLOCK TYPE CODE
This is the table itself with the current release entries. The start and finish of the table is
provided for structural understanding.
UHZ0002P CSECT
02760000
NUMENT
DC
F'0'
NUMBER OF ENTRIES
02770000
DC
A(FIRST)
POINT TO 1ST ENTRY
02780000
SERVICE 1,PGM=(UHRSTTLS,UHRSREGS)
02790000
SERVICE 2,PGM=(UHUC101P,UHUSSDIP,UHL0050P)
02800000
SERVICE 3,PGM=(UHRSREGS,UHL0050P)
02810000
* NDR/ESI ROUTING TABLE:
02820000
SERVICE 4,PGM=(UHL0200P,UHL0440P,UHLNDR2P)
02830000
SERVICE 5,PGM=(UHU101CP,MMRSSDIP,UHL0055P)
02850000
SERVICE 6,PGM=(UHL0055P,UHL0065P)
02860000
SERVICE 7,PGM=(UHU201CP,MMRSSDIP,UHL0055P)
02870000
* EXAM BOOKING TABLES AND CASH POSTING
02880000
SERVICE 8,PGM=(UHB0420P,UHB0400P,UHL0910P)
02890000
*
02900000
SERVICE 9,PGM=(UHL0055P,UHRSREGS)
02910000
SERVICE 10,PGM=(UHB0420P,UHB0400P,UHL0910P,UHB0700P,UHB0030P,UX02920000
HB0020P)
02930000
***
SERVICE 11,PGM=(UHB0420P,UHB0400P,UHL0910P,UHB0700P)
02940000
SERVICE 11,PGM=(UHB0420P,UHB0400P,UHL0910P,UHB0700P,UHL0236P,UX02950000
HB0030P,UHB0850P)
02960000
SERVICE 12,PGM=(UHL0120P,UHL0120P,UHL0231P)
02970000
Appendix C – Host Process Control Table
237
Registry of Motor Vehicles – UMS Programmer’s Manual
* IMAGE SERVER FUNCTIONS
02980000
SERVICE 13,PGM=(UHLIMG1P,UHL0200P,UHL0120P,UHL0065P,UHL0910P,UX02990000
HL1000P,UHL0930P)
03000000
SERVICE 14,PGM=(UHLIMG1P,UHL0200P)
03010000
SERVICE 15,PGM=(UHL0150P,UHL0212P,UHL0910P,UHL0400P,UHL0065P,UX03020000
HL0055P)
03030000
SERVICE 16,PGM=(UHL0065P,UHB0020P,UHL0910P,UHL0120P,UHL0055P,UX03040000
HL0234P)
03050000
SERVICE 17,PGM=(UHL0045P)
03060000
SERVICE 18,PGM=(UHL0214P,UHL0910P,UHL0217P)
03070000
SERVICE 19,PGM=(UHL0208P,UHL0910P,UHL0214P,UHL0217P,UHL0231P,UX03080000
HL0120P,UHLNDR1P,UHL0290P)
03090000
SERVICE 20,PGM=(MCCP996M,UHL0910P,UHL0231P,UHL0120P,UHL0140P,UX03100000
HL0120P,UHLNDR1P)
03110000
*
03120000
SERVICE 21,PGM=(UHL0208P,UHL0120P,UHL0065P,UHL0214P,UHL0910P,UX03130000
HL0217P,UHL0223P,UHL0470P)
03140000
SERVICE 22,PGM=(UHL0065P,UHB0020P,UHL0120P,UHL0055P,UHL2000T,UX03150000
HV0020P,UHL0920P)
03160000
SERVICE 23,PGM=(MCCPITEM)
03170000
SERVICE 24,PGM=(UHRSTTLS,UHRSREGS,UHL0055P)
03180000
SERVICE 25,PGM=(UHL0910P,MCCP991M,MSUSREIN,MRESPRNT)
03190000
SERVICE 26,PGM=(UHLNDR1P,UHL0910P,UHL0920P,UHL0930P)
03200000
* MAB SURRENDER UPDATE
03210000
SERVICE 27,PGM=(UHL0470P,UHL0120P,UHL0910P,UHL0065P,UHL0130P,UX03220000
HL0400P)
03230000
*
03240000
* HANDICAP PLACARD UPDATE
03250000
SERVICE 28,PGM=(UHL0670P,UHL0910P)
03260000
SERVICE 29,PGM=(UHU301CP,MMRSSDIP,UHL0055P)
03270000
SERVICE 30,PGM=(UHL0420P,UHL0400P)
03280000
* THIS SERVICE SET IS RESERVED FOR IMAGE TIMED EVENT PROCESSING
03290000
SERVICE 31,PGM=(UHLIMG1P,UHL0200P,UHL0120P,UHL0065P,UHL0910P,UX03320000
HL1000P,UHLIMG2P)
03330000
SERVICE 32,PGM=(UHR0560T,UHR0580P)
03340000
***
SERVICE 33,PGM=(UHL0236P,UHL0910P,UHB0550P,UHL1120P)
03350000
***
SERVICE 33,PGM=(UHL0236P,UHB0550P,UHL0910P,UHL1120P)
03360000
SERVICE 33,PGM=(UHL0236P,UHB0550P,UHL0910P,UHL1120P,UHL0208P,UX03370000
HL0930P)
03380000
SERVICE 34,PGM=(UHL0208P,UHB0020P)
03390000
SERVICE 35,PGM=(UHA0002P,UHA0006P,UHL0200P)
03400000
SERVICE 36,PGM=(UHB2020P)
03410000
SERVICE 37,PGM=(UHL1090T,UHL1090P,UHN0160P)
03420000
SERVICE 38,PGM=(UHL0208P,UHL0214P,UHL0930P,UHB0020P)
03430000
SERVICE 39,PGM=(UHL0208P,UHB0020P,UHL0910P,UHL0930P)
03440000
SERVICE 40,PGM=(UHL0208P,UHL0910P,UHL0214P,UHE0112P,UHL0055P,UX03450000
HE0111P,UHE0110P)
03460000
*
03470000
*
SERVICE 40,PGM=(UHB0650P,UHB0020P,UHL0910P,UHL0120P,UHL0236P,UX 03480000
*
HL0208P,UHL0920P,UHL0930P)
03490000
SERVICE 41,PGM=(UHRSREGS)
03500000
SERVICE 42,PGM=(UHL0065P,UHL0055P,UHL0920P,UHL0055P,UHL0055P) 03510000
SERVICE 43,PGM=(UHL0065P,UHL0055P,UHL0920P,UHB0900P,UHL0910P,UX03520000
HB0910P,UHL0930P)
03530000
* MAB - MEDICAL AFFAIRS BRANCH
03540000
*
SERVICE 44,PGM=(UHH0470P)
03550000
SERVICE 44,PGM=(UHH0470P,UHH0510P,UHH0350P,UHH0290P,UHL0670P,UX03560000
Appendix C – Host Process Control Table
238
Registry of Motor Vehicles – UMS Programmer’s Manual
HH0530P)
03570000
*
03580000
* NRT - NEW ROAD TEST PHASE 3
03590000
SERVICE 45,PGM=(UHL0920P,UHB0910P,UHL0910P,UHL0910P,UHL0910P,UX03600000
HL0910P,UHL0930P)
03610000
*
03620000
* MAB - MEDICAL AFFAIRS BRANCH
03630000
SERVICE 46,PGM=(UHH0620P,UHH0650P)
03640000
*
03650000
* NRT - ISSUE LICENSE FOR MOTORCYCLE COURSE
03660000
SERVICE 47,PGM=(UHL0236P,UHL0910P,UHL0910P,UHL0216P)
03670000
*
03680000
SERVICE 48,PGM=(UHL0208P,UHL0910P,UHL0120P,UHL0214P,UHL0910P,UX03690000
HL0217P,UHB0020P,UHL0290P)
03700000
* ACTIVITY HOLD
03710000
SERVICE 49,PGM=(UHL0790P,UHL0990P)
03720000
SERVICE 50,PGM=(UHL0208P,UHL0910P,UHL0214P,UHL0400P,UHL0231P,UX03730000
HL0120P,UHLNDR1P)
03740000
SERVICE 51,PGM=(UHL0150P,UHL0120P,UHL0470P,UHL0229P,UHL0065P,UX03750000
HL0055P,UHL0400P)
03760000
SERVICE 52,PGM=(UHN0310P)
03770000
*
03780000
* AV01 - ADDRESS VALIDATION
03790000
PCTEH AV01,PGM=(UHL1090P),SERVICE=37
03800000
*
03810000
* AV02 - ADDRESS REFORMAT
03820000
PCTEH AV02,PGM=(UHL1095P),SERVICE=37
03830000
*
03840000
* BH45 - EXAM BOOKING - EXTRACT ROAD TEST SITES FOR BKCL
03850000
PCTEH BH45,PGM=(UHB0450P),SERVICE=36
03860000
*
03870000
* BH46 - EXAM BOOKING - EXTRACT CLOSE OR REOPEN TEST SITES
03880000
PCTEH BH46,PGM=(UHB0460P),RMV=BKCL,SERVICE=11
03890000
*
03900000
* BH47 - EXAM BOOKING - VALIDATE DRIVING SCHOOL FID
03910000
PCTEH BH47,PGM=(UHB0470P),RMV=BKBB,SERVICE=36
03920000
*
03930000
* BH48 - EXAM BOOKING - DRIVING SCHOOL BLOCK BOOKING
03940000
PCTEH BH48,PGM=(UHB0480P),RMV=BKBB,SERVICE=11
03950000
*
03960000
* BH49 - EXAM BOOKING - EXTRACT ROAD TEST TIMES FOR BKCL
03970000
PCTEH BH49,PGM=(UHB0490P),RMV=BKCL
03980000
*
03990000
* BH55 - EXAM BOOKING - VALIDATE CONFIRMATION NUMBER
04000000
PCTEH BH55,PGM=(UHB0550P) 98
04010000
* BH65 - EXAM BOOKING - DETERMINE BOOKING/CANCEL OPTIONS
04020000
PCTEH BH65,PGM=(UHB0650P),SERVICE=16
04030000
*
04040000
PCTEH BH75,PGM=(UHB0750P),RMV=ED,SERVICE=10
04050000
* BH85 - EXAM BOOKING - ISSUE LICENSE APPL & BOOK ROAD TEST
04060000
***
PCTEH BH85,PGM=(UHB0850P),SERVICE=33
04070000
PCTEH BH85,PGM=(UHB0850P),SERVICE=11
04080000
***
PCTEH BH85,PGM=(UHB0850P),SERVICE=40
04090000
* BH86 - EXAM BOOKING - CANCEL ROAD TEST
04100000
PCTEH BH86,PGM=(UHB0860P),RMV=BK01,SERVICE=33
04110000
* BH87 - EXAM BOOKING - MARK ALL ROAD TEST PAID
04120000
PCTEH BH87,PGM=(UHB0870P),RMV=BK01,SERVICE=38
04130000
Appendix C – Host Process Control Table
239
Registry of Motor Vehicles – UMS Programmer’s Manual
* BH90 - EXAM BOOKING - BUILD ROAD EXAMS SCHEDULE
04140000
****
PCTEH BH90,PGM=(UHB0900P),SERVICE=16
04150000
PCTEH BH90,PGM=(UHB0900P),SERVICE=42
04160000
* BH91 - EXAM BOOKING - UPDATE EXAM HISTORY FILE
04170000
PCTEH BH91,PGM=(UHB0910P),SERVICE=13
04180000
* BH94 - EXAM BOOKING - BUILD ROAD EXAMS SCHEDULE / UPDATE EXAM HISTORY 04190000
PCTEH BH94,PGM=(UHB0940P),SERVICE=43
04200000
* BH95 - EXAM BOOKING - EXTRACT LICENSING FEES
04210000
PCTEH BH95,PGM=(UHB0950P),SERVICE=34
04220000
* BH97 - GRADE EXAM - CASH POSTING
04230000
PCTEH BH97,PGM=(UHB0970P),SERVICE=8
04240000
* URBS - UMS REGISTRATION BANK SCROLL
04250000
PCTEH BS01,PGM=(UHR1203P),RMV=RBS,SERVICE=1
04260000
* RBS - UMS REGISTRATION BANK SCROLL
04270000
PCTEH BS02,PGM=(UHR2203P),RMV=RBS,SERVICE=1
04280000
* UCCR CREDIT CARD RECONCILIATION
04290000
PCTEH CC06,PGM=(UHC0613P),RMV=CCR
04300000
* BAD PAYMENT HISTORY INQUIRY BY LIC
04310000
PCTEH CIC1,PGM=(UHC1043P),RMV=CIC,SERVICE=24,DUPKEY=LI04
04320000
* BAD PAYMENT HISTORY INQUIRY BY FID
04330000
PCTEH CIC2,PGM=(UHC1043P),RMV=CIC,SERVICE=24,DUPKEY=UR09
04340000
* BAD PAYMENT HISTORY INQUIRY BY REG
04350000
PCTEH CIC3,PGM=(UHC1043P),RMV=CIC,SERVICE=24,DUPKEY=UR05
04360000
* BAD PAYMENT HISTORY INQUIRY BY CITA
04370000
PCTEH CIC4,PGM=(UHC1043P),RMV=CIC,SERVICE=24,DUPKEY=UMVX
04380000
* BAD PAYMENT HISTORY INQUIRY BY PLATE ORDER ( PLTO )
04390000
PCTEH CIC5,PGM=(UHC1043P),RMV=CIC,SERVICE=24
04400000
* BAD PAYMENT HISTORY INQUIRY BY TITLE
04410000
PCTEH CIC6,PGM=(UHC1043P),RMV=CIC,SERVICE=24
04420000
* COR - OBLIGATION RESOLUTION INQUIRY BY REG
04430000
PCTEH COR2,PGM=(UHS1193P),RMV=COR,DUPKEY=UR05,
X04440000
SERVICE=1
04450000
* COR
OBLIGATION RESOLUTION INQUIRY BY LICENSE
04460000
PCTEH COR3,PGM=(UHS1193P),RMV=COR,DUPKEY=LI04,
X04470000
SERVICE=1
04480000
* COR1 OBLIGATION RESOLUTION DETAILS
04490000
PCTEH COR4,PGM=(UHS1203P),RMV=COR1
04500000
* RETURNED CHECK RESOLUTION INQUIRY
04510000
PCTEH CPD1,PGM=(UHC1033P),RMV=CPD,SERVICE=25
04520000
* RETURNED CHECK RESOLUTION NON CITATION UPDATE
04530000
PCTEH CPD2,PGM=(UHC1034P),RMV=CPD,SERVICE=25
04540000
* RETURNED CHECK RESOLUTION CITATION UPDATE
04550000
PCTEH CPD3,PGM=(UHC1035P),RMV=CPD,SERVICE=25
04560000
* CCP - CMVI CITATION (INQ BY CITA)
04570000
PCTEH CP01,PGM=(UHC0013P,UHC0014P),RMV=CCP,DUPKEY=UMVX
04580000
* CCP - CMVI CITATION (INQ BY REG)
04590000
PCTEH CP02,PGM=(UHC0013P,UHC0014P),RMV=CCP,DUPKEY=UR05
04600000
* CCP - CMVI CITATION (INQ BY LICENSE OR NOWN NAME
04610000
PCTEH CP03,PGM=(UHC0013P,UHC0014P),RMV=CCP
04620000
* CCP - CMVI CITATION (UPDATE)
04630000
PCTEH CP04,PGM=(UHC0014P),RMV=CCP
04640000
* DATE - COMPARE PC DATE TO EIBDATE
04650000
PCTEH DATE,PGM=(UHL1170P)
04660000
* DI01 - MULTIPLE PLATE INQUIRY SECTION V
04670000
PCTEH DI01,PGM=(UHR1823P),RMV=DI01,SERVICE=41
04680000
* DRVP - VANITY PLATE ORDER
SECTION V
04690000
PCTEH DRVP,PGM=(UHR1843P),RMV=DRVP
04700000
Appendix C – Host Process Control Table
240
Registry of Motor Vehicles – UMS Programmer’s Manual
* DR01 - PLATE ADD AND AMEND FOR SECTION V
PCTEH DR01,PGM=(UHR1803P),RMV=DRPL,SERVICE=1
* DR02 - ADDRESS ADD AND AMEND FOR SECTION V
PCTEH DR02,PGM=(UHR1813P),RMV=DRAD,SERVICE=1
*
* EXAM DISTANCE CHECK, PROD LOOKUP
PCTEH EBDC,PGM=(UHB2040P),RMV=EBDC
* EXAM DISTANCE CHECK, TEST LOOKUP
PCTEH EBDD,PGM=(UHB2040P),FLAGS=00EE000000000000,RMV=EBDC
* EXAM DISTANCE CHECK, TEST LOOKUP
PCTEH EBDT,PGM=(UHB2040P),FLAGS=C900000000000000,RMV=EBDC
* EXAM DISTANCE CHECK, TEST LOOKUP
PCTEH EBDU,PGM=(UHB2040P),FLAGS=C9EE000000000000,RMV=EBDC
* EXAM LOCATION INQUIRY
PCTEH EBLI,PGM=(UHB2020P),RMV=EBLM
* EXAM LOCATION MAINTENANCE
PCTEH EBLM,PGM=(UHB2020P),FLAGS=E400000000000000,RMV=EBLM
* EXAM OFFICE INQUIRY
PCTEH EBOI,PGM=(UHB2060P),RMV=EBOM
* EXAM OFFICE MAINTENANCE
PCTEH EBOM,PGM=(UHB2060P),FLAGS=E400000000000000,RMV=EBOM
* EXAM ZIP INQUIRY
PCTEH EBZI,PGM=(UHB2000P),RMV=EBZM
* EXAM ZIP MAINTENANCE
PCTEH EBZM,PGM=(UHB2000P),FLAGS=E400000000000000,RMV=EBZM
*
* EXAM BOOKING SCHEDULE DATASET FETCH AND UPDATE (PRE-CDL)
PCTEH EB01,PGM=(UHB0010P),RMV=ED,SERVICE=8
* EXAM HISTORY DATASET FETCH AND UPDATE
PCTEH EB02,PGM=(UHB0020P),RMV=EB,SERVICE=8
*
* EXAM BOOKING SCHEDULE DATASET FETCH AND UPDATE (CDL IMPLEMENTATION)
PCTEH EB03,PGM=(UHB0030P),RMV=ED,SERVICE=11
* EXAM BOOKING GRADE MULTIPLE PENDING EXAMS FOR IMAGING
PCTEH EB05,PGM=(UHB0050P),RMV=EB,SERVICE=39
* EXAM BOOKING GET EXAM HISTORY FOR CUSTOMER
PCTEH EB06,PGM=(UHB0060P),RMV=EGCO
* EXAM BOOKING EXAM BLOCK APPOINTMENT UPDATE
PCTEH EB40,PGM=(UHB0040P),RMV=ED,SERVICE=10
* FCP - FOREIGN CASH POSTING
- VERSION 1
PCTEH FC01,PGM=(UHC1023P),RMV=FCP
*
PCTEH HIST,PGM=(UHL0411P),SERVICE=14
* HOST VSAM IO FUNCTIONS
*
EVR SOLICITED AND UNSOLICITED FILES
PCTEH HI00,PGM=(UHZ0060P,UHL0200P,UHZ0061P)
PCTEH HI01,PGM=(UHZ0060P,UHL0200P,UHZ0061P)
* TABLE LOAD FUNCTIONS:
PCTEH HTB0,PGM=(UHZ0004P,UHZ0006P)
PCTEH HTB1,PGM=(UHZ0004P)
PCTEH HTB2,PGM=(UHZ0004P,MRMXWAFL)
PCTEH HTB3,PGM=(UHZ0004P,UHZ0007P)
PCTEH HTB4,PGM=(UHZ0004P,UHZ0102P)
PCTEH HTB5,PGM=(UHZ0004P,UHZ0103P)
PCTEH HTB6,PGM=(UHZ0004P,UHZ0104P)
PCTEH HTB7,PGM=(UHZ0004P,UHZ0010P)
PCTEH HTB8,PGM=(UHZ0004P,UHZ0012P)
Appendix C – Host Process Control Table
04710000
04720000
04730000
04740000
04750000
04760000
04770000
04780000
04790000
04800000
04810000
04820000
04830000
04840000
04850000
04860000
04870000
04880000
04890000
04900000
04910000
04920000
04930000
04940000
04950000
04960000
04970000
04980000
04990000
05000000
05010000
05020000
05030000
05040000
05050000
05060000
05070000
05080000
05090000
05100000
05110000
05120000
05130000
05140000
05150000
05160000
05170000
05180000
05190000
05200000
05210000
05220000
05230000
05240000
05250000
05260000
05270000
241
Registry of Motor Vehicles – UMS Programmer’s Manual
* IMAGE SERVER HOST FUNCTIONS:
PCTEH IHA0,PGM=(UHL1000P),RMV=LZI1,SERVICE=13,
FLAGS=C100000000000000
PCTEH IHB0,PGM=(UHL1020P),RMV=LZI1,SERVICE=14,
FLAGS=C200000000000000
PCTEH IHC0,PGM=(UHL1000P),RMV=LZI1,SERVICE=13,
FLAGS=C300000000000000
PCTEH IHD0,PGM=(UHL1000P),RMV=LZI1,SERVICE=13,
FLAGS=C400000000000000
PCTEH IHE0,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
FLAGS=C500000000000000
PCTEH IHG0,PGM=(UHL1040P),RMV=LZI2,SERVICE=13,
FLAGS=C700000000000000
* IDENTICAL TO IHG0 EXCEPT SECURITY COMES FROM UDUP
PCTEH IHG1,PGM=(UHL1040P),RMV=UDUP,SERVICE=13,
FLAGS=C700000000000000
* IDENTICAL TO IHG0, BUT FORCES A DELAY OF ZERO.
* THIS IS USED BY BULK RESUBMISSION, TRIGGERED BY FLAGS+1=01
PCTEH IHG2,PGM=(UHL1040P),RMV=LZI2,SERVICE=31,
FLAGS=C701000000000000
PCTEH IHH0,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
FLAGS=C800000000000000
PCTEH IHI0,PGM=(UHL1040P),RMV=LZI2,SERVICE=13,
FLAGS=C900000000000000
PCTEH IHJ0,PGM=(UHL1000P),RMV=LZI3,SERVICE=13,
FLAGS=D100000000000000
PCTEH IHK0,PGM=(UHL1000P),RMV=LZI3,SERVICE=13,
FLAGS=D200000000000000
PCTEH IHL0,PGM=(UHL1020P),RMV=LZI1,SERVICE=13,
FLAGS=D300000000000000
PCTEH IHM0,PGM=(UHL1000P),RMV=LZI1,SERVICE=13,
FLAGS=D400000000000000
PCTEH IHN0,PGM=(UHL1000P),RMV=LZI3,SERVICE=13,
FLAGS=D500000000000000
PCTEH IHP0,PGM=(UHL1000P),RMV=LZI3,SERVICE=13,
FLAGS=D700000000000000
PCTEH IHQ0,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
FLAGS=D800000000000000
PCTEH IHT0,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
FLAGS=D800000000000000
* ILA2 - UPDATE TRAINING INFORMATION BY RMV
PCTEH ILA2,PGM=(UHE0102P),RMV=ILRU,SERVICE=40
* IL01 - INSPECTOR TRAINING AUTHORIZATION
PCTEH IL01,PGM=(UHE0101P),RMV=ILVI,SERVICE=40
* IL02 - UPDATE TRAINING INFORMATION BY VENDOR
PCTEH IL02,PGM=(UHE0102P),RMV=ILVU,SERVICE=40
* IL03 - ADD APPLICANT TO DATA BASE
PCTEH IL03,PGM=(UHE0103P),RMV=ILRU,SERVICE=40
* IL04 - AUTHORIZE INSPECTOR
PCTEH IL04,PGM=(UHE0104P),RMV=ILVI,SERVICE=40
* IL05 - RETRIEVE INSPECTOR/APPLICANT INFORMATION
PCTEH IL05,PGM=(UHE0105P),RMV=ILRI
* IL06 - UPDATE INSPECTOR/APPLICANT INFORMATION
PCTEH IL06,PGM=(UHE0106P),RMV=ILRU,SERVICE=40
* IL07 - DELETE INSPECTOR LICENSE
PCTEH IL07,PGM=(UHE0107P),RMV=ILDI,SERVICE=40
* IL08 - DELETE APPLICANT
Appendix C – Host Process Control Table
05280000
X05290000
05300000
X05310000
05320000
X05330000
05340000
X05350000
05360000
X05370000
05380000
X05390000
05400000
05410000
X05420000
05430000
05440000
05450000
X05460000
05470000
X05480000
05490000
X05500000
05510000
X05520000
05530000
X05540000
05550000
X05560000
05570000
X05580000
05590000
X05600000
05610000
X05620000
05630000
X05640000
05650000
X05660000
05670000
05720000
05730000
05740000
05750000
05760000
05770000
05780000
05790000
05800000
05810000
05820000
05830000
05840000
05850000
05860000
05870000
05880000
242
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH IL08,PGM=(UHE0107P),RMV=ILRU,SERVICE=40
05890000
* IL09 - ISSUE INSPECTOR LICENSE
05900000
PCTEH IL09,PGM=(UHE0109P),RMV=ILRU,SERVICE=40
05910000
* IL10 - PRINT INSPECTOR LICENSE
05920000
PCTEH IL10,PGM=(UHE0110P),RMV=ILRU,SERVICE=40
05930000
* IL13 - RETRIEVE INSPECTOR LICENSE HISTORY
05940000
PCTEH IL13,PGM=(UHE0113P),RMV=ILRI,SERVICE=40
05950000
* IL14 - RENEW INSPECTOR LICENSE
05960000
PCTEH IL14,PGM=(UHE0114P),RMV=ILRU,SERVICE=40
05970000
* IMU - INSPECTION HISTORY UPDATE INPUT
06000000
PCTEH IM01,PGM=(UHI1353P),RMV=IMU,SERVICE=3
06010000
* IMU - INSPECTION HISTORY UPDATE OUTPUT
06020000
PCTEH IM02,PGM=(UHI1354P),RMV=IMU
06030000
* IMU - INSPECTION UPDATE
06040000
*
PCTEH IM02,PGM=(UHI1353P),RMV=IMU
06050000
* UIMQ INPECTION DRIVER CONTROL
06070000
PCTEH IM03,PGM=(UHI1323P,UHI1324P,UHI1325P),RMV=IMQ
06080000
* IMI - INSPECTION HISTORY INQUIRY
06100000
PCTEH IM04,PGM=(UHI1343P),RMV=IMI
06110000
***************************************************************
06130000
* IMAGING PRINTING OF FREE-FORM DOCUMENTS
06140000
***************************************************************
06150000
* GET DOCUMENT TEMPLATE
06160000
PCTEH IP01,PGM=(UHU3100P)
06170000
* GET VARIABLE DATA
06180000
PCTEH IP02,PGM=(UHU3200P)
06190000
* GET DOCUMENT DEFAULT PRINTER
06200000
PCTEH IP03,PGM=(UHU3300P)
06210000
***************************************************************
06220000
* IMAGING SECURITY:
06230000
PCTEH ISEC,PGM=(UHZ0030P,UHZ0032P,UHZ0031P),RMV=LI
06240000
* MAB PRINT MODULE SELECTOR
06250000
PCTEH IW01,PGM=(IWP1000P),RMV=LI
06260000
* IDENTICAL TO IHE0 (USED FOR AUTOMATIC STORAGE AUTHORIZATION REQUEST) 06270000
* USED TO RECOVER LOST IMAGES
06280000
PCTEH IXE0,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
X06290000
FLAGS=C500000000000000
06300000
* REPORT IMAGE NOT TRANSFERRED TO HOST FROM IMAGE SERVER
06310000
PCTEH IXF0,PGM=(UHL1130P,UHL0200P),RMV=LZI1
06320000
* INTERNAL FUNCTION (USED TO DELETE TRACKING RECORDS)
06330000
PCTEH IXZZ,PGM=(UHL1000P),RMV=LZI2,SERVICE=13,
X06340000
FLAGS=0000000000000000
06350000
* LICENSE ADDRESS CHANGE HIST BY SURR
06360000
PCTEH LAC1,PGM=UHL3320P,RMV=LI
06380000
PCTEH LAI1,PGM=(UHL0070P,UHL3300P),RMV=LI,DUPKEY=LI04
06390000
* LICENSE ADDRESS INFORMATION BY SURR
06400000
PCTEH LAI2,PGM=UHL3300P,RMV=LI
06410000
* GENERALIZED FETCHER OF BREFS:
06420000
PCTEH LB10,PGM=(UHL0420P),RMV=LI
06430000
* GENERALIZED FETCHER OF BREF BATCH NUMBERS:
06440000
PCTEH LB11,PGM=(UHL1140P),RMV=LI,SERVICE=30
06450000
* DUPLICATE SSN SCROLL
06460000
PCTEH LD04,PGM=(UHL0500P),RMV=LP
06470000
* DUPLICATE OOS SCROLL
06480000
PCTEH LD08,PGM=(UHL0520P),RMV=LP
06510000
* LICENSE HISTORY LOOK-UP BY LICENSE #
06520000
PCTEH LH10,PGM=(UHL0070P,UHL0060P),
X06530000
Appendix C – Host Process Control Table
243
Registry of Motor Vehicles – UMS Programmer’s Manual
RMV=LI,DUPKEY=LI04
* LICENSE HISTORY LOOK-UP BY OOS #
PCTEH LH20,PGM=(UHL0080P,UHL0060P),
RMV=LI,DUPKEY=LD08
* LICENSE HISTORY LOOK-UP BY SURROGATE
PCTEH LH30,PGM=(UHL0060P),RMV=LI
* LICENSE HISTORY COMMERCIAL EXTENSION -- SURROGATE ONLY
PCTEH LH40,PGM=(UHL0095P),RMV=LI
* LICENSE UNISITE GROUP LOOKUP:
PCTEH LIGP,PGM=(UHL0800P),RMV=LI
* LICENSE IMAGE HISTORY LOOKUP:
PCTEH LIIH,PGM=(UHL0261P),RMV=LI
* LICENSE INQUIRY
PCTEH LI01,PGM=(UHL0010P),RMV=LI,DUPKEY=LI04
PCTEH LI02,PGM=(UHL0030P),RMV=LI
* LICENSE PERSON SCROLL
PCTEH LI03,PGM=(UHL0040P),RMV=LP,SERVICE=17
* LICENSE NUMBER SCROLL
PCTEH LI04,PGM=(UHL0020P),RMV=LP
* LICENSE HISTORY
PCTEH LI06,PGM=(UHL0060P),RMV=LI
* LICENSE INQUIRY (BY LIC. NUMBER) (NEW)
PCTEH LI07,PGM=(UHL0070P,UHL0100P,UHL0110P),SERVICE=6,
RMV=LI,DUPKEY=LI04,FLAGS=0003000000000000
* LICENSE INQUIRY (BY OOS NUMBER) (NEW)
PCTEH LI08,PGM=(UHL0080P,UHL0100P,UHL0110P),SERVICE=6,
RMV=LI,DUPKEY=LD08,FLAGS=0003000000000000
* LICENSE INQUIRY (BY SSN NUMBER) (NEW)
PCTEH LI09,PGM=(UHL0090P,UHL0100P,UHL0110P),SERVICE=6,
RMV=LI,DUPKEY=LD04,FLAGS=0003000000000000
* LICENSE INQUIRY (BY SURROGATE) (NEW)
PCTEH LI10,PGM=(UHL0100P,UHL0110P),SERVICE=6,
RMV=LI,FLAGS=0002000000000000
* LICENSE INQUIRY (BY SURROGATE) (LAST PART OF DETAIL) (NEW)
PCTEH LI11,PGM=(UHL0110P),RMV=LI,SERVICE=6
* ENDORSEMENT INQUIRY BY SURROGATE
PCTEH LI12,PGM=(UHL0120P),RMV=LI
* CDL DRIVER TYPE HOST FUNCTION
PCTEH LI14,PGM=(UHL0140P),RMV=LI
* S-NUMBER GENERATOR HOST FUNCTION
PCTEH LI15,PGM=(UHL0150P),RMV=LC
* GET CONTROL RECORD
PCTEH LI17,PGM=(UHL0540P),RMV=LC,SERVICE=4
* GET LC SECURITY
PCTEH LI18,PGM=(UHL1100P),RMV=LC
* NDR INQUIRY HOST FUNCTION
PCTEH LI19,PGM=(UHL1080P),RMV=LC,SERVICE=26
* CUSTOMER ADD HOST FUNCTION
PCTEH LI20,PGM=(UHL1060P),RMV=LC,SERVICE=15
* CREATE PERMIT APPLICATION HOST FUNCTION
PCTEH LI21,PGM=(UHL0201P),SERVICE=19,
RMV=LIC1
* ISSUE PERMIT HOST FUNCTION
PCTEH LI22,PGM=(UHL0202P),SERVICE=19,
RMV=LIC2
* ISSUE LICENSE HOST FUNCTION
PCTEH LI23,PGM=(UHL0203P),SERVICE=19,
Appendix C – Host Process Control Table
06540000
06550000
X06560000
06570000
06580000
06590000
06600000
06610000
06620000
06630000
06640000
06650000
06660000
06670000
06680000
06690000
06700000
06710000
06720000
06730000
06740000
06750000
X06760000
06770000
06780000
X06790000
06800000
06810000
X06820000
06830000
06840000
X06850000
06860000
06870000
06880000
06890000
06900000
06910000
06920000
06930000
06940000
06950000
06960000
06970000
06980000
06990000
07000000
07010000
07020000
07030000
X07040000
07050000
07060000
X07070000
07080000
07090000
X07100000
244
Registry of Motor Vehicles – UMS Programmer’s Manual
RMV=LIC4
* ISSUE MASS & LIQUOR ID HOST FUNCTION
PCTEH LI24,PGM=(UHL0204P),SERVICE=19,
RMV=LM
* UPDATE LICENSE EXPIRATION DATE FUNCTION
PCTEH LI25,PGM=(UHL0205P),SERVICE=48,
RMV=LIC4
* DELETE MASS & LIQUOR ID HOST FUNCTION
PCTEH LI26,PGM=(UHL0206P),RMV=LM
* DELETE PERMIT RECORD HOST FUNCTION
PCTEH LI27,PGM=(UHL0207P),SERVICE=19,
RMV=LIC2
* GET FEE TABLE RECORD HOST FUNCTION
PCTEH LI28,PGM=(UHL0208P)
* STORE AND MODIFY MMVR-PSSN
PCTEH LI29,PGM=(UHL0209P),RMV=LC
* STORE MMVR-UNOP
PCTEH LI30,PGM=(UHL0210P),RMV=LC
* MODIFY MMVR-UNOP
PCTEH LI31,PGM=(UHL0211P),RMV=LC
* LICENSE NUMBER CHANGE
PCTEH LI32,PGM=(UHL0212P),RMV=LC
* CASH POSTING
PCTEH LI33,PGM=(UHL0213P),SERVICE=19
* VERIFY FEE
PCTEH LI34,PGM=(UHL0214P),SERVICE=19
* DELETE LICENSE
PCTEH LI35,PGM=(UHL0215P),SERVICE=19,RMV=LIC4
* EXAM OVERRIDE
PCTEH LI36,PGM=(UHL0216P),SERVICE=26,RMV=LIC2
* REMOVE EXAM OVERRIDE
PCTEH LI37,PGM=(UHL0217P),SERVICE=19,RMV=LIC2
* CREDIT CARD AUTHORIZATION
PCTEH LI38,PGM=(UHL0218P),SERVICE=20,RMV=LIC4
* RXX REINSTATE LICENSE
PCTEH LI39,PGM=(UHL0219P),SERVICE=21,RMV=LIC4
* RXW REINSTATE LICENSE
PCTEH LI40,PGM=(UHL0245P),SERVICE=21,RMV=LIC4
* RXP COLLECT REINSTATEMENT FEE AND APPLY FOR EXAM
PCTEH LI41,PGM=(UHL0221P),SERVICE=19,RMV=LIC1
* BUILD DESCRIPTIVE TABLE
PCTEH LI42,PGM=(UHL0222P),SERVICE=13
* FORCED LICENSE CLASS DOWNGRADE
PCTEH LI43,PGM=(UHL0223P),SERVICE=21,RMV=LIC4
* RXW ISSUE PERMIT
PCTEH LI44,PGM=(UHL0224P),SERVICE=19,RMV=LIC4
* RETRIEVE LICENSE DATA
PCTEH LI45,PGM=(UHL0225P),SERVICE=16
* UPDATE ENDORSEMENT DATA
PCTEH LI46,PGM=(UHL0226P),SERVICE=16,RMV=LIC1
* SNAP PRINT OF LICENSE/ENDORSEMENTS/RESTRICTION
PCTEH LI47,PGM=(UHL0470P),RMV=LI,SERVICE=12
* UPDATE RESTRICTION DATA
PCTEH LI48,PGM=(UHL0228P,UHL0400P),SERVICE=21,RMV=LR
* I OR K RESTRICTION ASSIGNMENT
PCTEH LI49,PGM=(UHL0229P),SERVICE=51,RMV=LR
* STAND ALONE CASH POSTING FOR APWS
Appendix C – Host Process Control Table
07110000
07120000
X07130000
07140000
07150000
X07160000
07170000
07180000
07190000
07200000
X07210000
07220000
07230000
07240000
07250000
07260000
07270000
07280000
07290000
07300000
07310000
07320000
07330000
07340000
07350000
07360000
07370000
07380000
07390000
07400000
07410000
07420000
07430000
07440000
07450000
07460000
07470000
07480000
07490000
07500000
07510000
07520000
07530000
07540000
07550000
07560000
07570000
07580000
07590000
07600000
07610000
07620000
07630000
07640000
07650000
07660000
07670000
245
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH LI5A,PGM=(UHL0510P),SERVICE=19
* STAND ALONE CASH POSTING
PCTEH LI50,PGM=(UHL0230P),SERVICE=19
* NDR INQUIRY HOST FUNCTION
PCTEH LI51,PGM=(UHL0235P,UHL0231P),SERVICE=19,
FLAGS=C440000000000000,RMV=LX
* CHECK FOR BAD CHECK INTERFACE FUNCTION
PCTEH LI52,PGM=(UHL0232P),SERVICE=23
* UPDATE PERSONAL RECORD WITH GENERATED LICENSE NUMBER
PCTEH LI53,PGM=(UHL0233P),RMV=LC,SERVICE=15
* OBTAIN OUT OF STATE DATA
PCTEH LI54,PGM=(UHL0234P),RMV=LIC1,SERVICE=16
* ISSUE LICENSE HOST FUNCTION OOS CONVERSION
PCTEH LI55,PGM=(UHL0203P),SERVICE=19,
RMV=LIC4
* CREATE LICENSE APPLICATION HOST FUNCTION
***
PCTEH LI56,PGM=(UHL0236P),SERVICE=19,
PCTEH LI56,PGM=(UHL0236P),SERVICE=33,
RMV=LIC3
* ISSUE PERMIT HOST FUNCTION (CONVERSION)
PCTEH LI57,PGM=(UHL0202P),SERVICE=19,
RMV=LIC2
* CASH POSTING FOR PROCESS ENDORSEMENT
PCTEH LI58,PGM=(UHL0238P),SERVICE=19
* RETRIEVE DESCRIPTION FROM MMVR-VTAB
PCTEH LI59,PGM=(UHL0239P),SERVICE=19,RMV=LI
* PLACARD RECORD CANCEL OR PURGE
PCTEH LI60,PGM=(UHL0680P),SERVICE=28,RMV=PLCP
* OUT OF STATE LICENSE CONVERSION
PCTEH LI61,PGM=(UHL1061P),RMV=LIC4,SERVICE=20
* UPDATE UNPAID WRITTEN EXAMS
PCTEH LI62,PGM=(UHL0290P),SERVICE=19
* RETRIEVE DESCRIPTION FROM MMVR-ORES
PCTEH LI63,PGM=(UHL0243P),SERVICE=19,RMV=LI
* CALCULATE REINSTATEMENT FEES
PCTEH LI64,PGM=(UHL0244P),SERVICE=19,RMV=LI
* RXW REINSTATE LICENSE RENEW
PCTEH LI65,PGM=(UHL0245P),SERVICE=21,RMV=LIC4
* RXP COLLECT FEE AND PRINT LICENSE
PCTEH LI66,PGM=(UHL0221P),SERVICE=19,RMV=LIC1
* P-NUMBER GENERATOR HOST FUNCTION
PCTEH LI67,PGM=(UHL0670P),RMV=LC
* PLACARD RECORD UPDATE
PCTEH LI68,PGM=(UHL0680P),SERVICE=28,RMV=PLCD
* PLACARD RECORD LOOKUP
PCTEH LI69,PGM=(UHL0690P)
* NOSSN OVERRIDE / REMOVE OVERRIDE
PCTEH LI70,PGM=(UHL1070P),SERVICE=19
* BUILD DEPT, DEPT NAME, DEPT EXT TABLE FOR ACTIVITY HOLD
PCTEH LI71,PGM=(UHL0710P),SERVICE=49
* AUTOMATIC ADJUST MANUFACTURE
PCTEH LI72,PGM=(UHL1072P),SERVICE=19
* CUSTOMER ACTIVITY FUNCTION
PCTEH LI73,PGM=(UHL0730P),SERVICE=30,RMV=LIC1
* RETRIEVE MMVR-PERS-EXT (ACTIVITY HOLD)
PCTEH LI74,PGM=(UHL0740P),SERVICE=49,RMV=LIH4
* ISSUE LICENSE WITHOUT "O" RESTRICTION
Appendix C – Host Process Control Table
X
07680000
07690000
07700000
07710000
X07720000
07730000
07740000
07750000
07760000
07770000
07780000
07790000
07800000
X07810000
07820000
07830000
07840000
X07850000
07860000
07870000
X07880000
07890000
07900000
07910000
07920000
07930000
07940000
07950000
07960000
07970000
07980000
07990000
08000000
08010000
08020000
08030000
08040000
08050000
08060000
08070000
08080000
08090000
08100000
08110000
08120000
08130000
08140000
08150000
08160000
08170000
08180000
08190000
08200000
08210000
08220000
08230000
08240000
246
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH LI75,PGM=(UHL0750P),SERVICE=19,RMV=LIC4
* MAB SURRENDER UPDATE FUNCTION
PCTEH LI76,PGM=(UHL0760P),SERVICE=27,RMV=MSRU
*
* MAB SURRENDER INQUIRY FUNCTION
PCTEH LI77,PGM=(UHL0770P),RMV=MSRI
*
* HANDICAPPED PERS-EXT BUILD
PCTEH LI78,PGM=(UHL0078P),SERVICE=13,RMV=LZI1,
FLAGS=C300000000000000
* RETRIEVE OFFC-NAME FROM MMVR-OFFC USING OFFC-NUMB
PCTEH LI79,PGM=(UHL0790P)
* SSN VERIFICATION
* GT0400 PCTEH LI80,PGM=(UHL0081P),SERVICE=13
* LI81 - UPDATE LICENSING PAYMENT INFORMATION
PCTEH LI81,PGM=(UHL0810P),SERVICE=38,RMV=LIC4
* LI82 - RETRIEVE RESTRICTION RECORDS
PCTEH LI82,PGM=(UHL0180P)
* LI83 - ADD / UPDATE RESTRICTION RECORDS
PCTEH LI83,PGM=(UHL0190P)
* LICENSE PERSON UPDATE (NEW)
PCTEH LI85,PGM=(UHL0085P),RMV=LC,SERVICE=51
* SSN VERIFICATION AND RESOLUTION
PCTEH LI87,PGM=(UHL0870P),RMV=LSSN,SERVICE=4
* SSN VERIFICATION REQUEST
PCTEH LI88,PGM=(UHL0880P),SERVICE=13,RMV=LI
* VALIDATE DEMOGRAPHICS FOR L1 SCREEN
PCTEH LI89,PGM=(UHL0890P)
* LI90 - MAINTAIN THE PENDING ISSUE TRANSACTION FILE
PCTEH LI90,PGM=(UHL4000P),SERVICE=8
* LI91 - RETRIEVE THE PENDING ISSUE TRANSACTIONS
PCTEH LI91,PGM=(UHL4500P),SERVICE=45
* LI92 - READ THE PAYMENT LOG FILE
PCTEH LI92,PGM=(UHL0920P)
* LI93 - UPDATE THE PAYMENT LOG FILE
PCTEH LI93,PGM=(UHL0930P)
* LI94 - ISSUE PERMIT HOST FUNCTION (ISSUE DATE)
PCTEH LI94,PGM=(UHL0202P),SERVICE=19,
RMV=LIC2,FLAGS=C900000000000000
* LI95 - RETRIEVE PAYMENT LOG
PCTEH LI95,PGM=(UHL0940P)
* LI96 - GENERATE EXPIRATION DATE (ONLY PERMIT FOR NOW)
PCTEH LI96,PGM=(UHL0960P)
* LI97 - LICENSE ISSUE FOR MOTORCYCLE COURSE
PCTEH LI97,PGM=(UHL0970P),SERVICE=47
* LI98 - DETERMINE ACTIVITY HOLD STATUS
PCTEH LI98,PGM=(UHL0980P)
Appendix C – Host Process Control Table
08250000
08260000
08270000
08280000
08290000
08300000
08310000
08320000
X08330000
08340000
08350000
08360000
08370000
08380000
08390000
08400000
08410000
08420000
08430000
08440000
08450000
08460000
08470000
08480000
08490000
08500000
08510000
08520000
08530000
08540000
08550000
08560000
08570000
08580000
08590000
08600000
08610000
08620000
08630000
08640000
08650000
08660000
08670000
X08680000
08690000
08700000
08710000
08720000
08730000
08740000
08750000
08760000
08770000
08780000
08790000
08800000
08810000
247
Registry of Motor Vehicles – UMS Programmer’s Manual
* MANUFACTURE HISTORY INQUIRE
PCTEH LM01,PGM=(UHL3200P),SERVICE=4,RMV=LI
* LOTTERY INQUIRY FUNCTION
PCTEH LOT1,PGM=(UHN0200P),SERVICE=9,RMV=RI
* SOCIAL SECURITY NUMBER DELETE FUNCTION
PCTEH LSSD,PGM=(UHL1200P,UHL0400P),RMV=LSSD
*
* MOTOR VOTER PERS-EXT BUILD
PCTEH LV20,PGM=(UHV0020P),SERVICE=13,RMV=LZI1,
FLAGS=C300000000000000
* MOTOR VOTER REGISTRATION HISTORY
PCTEH LV30,PGM=(UHV0030P),RMV=LIMV
* MOTOR VOTER NAME AND ADDRESS INFORMATION
PCTEH LV31,PGM=(UHV0031P),RMV=LIMV
* MOTOR VOTER REGISTER TO VOTE
PCTEH LV32,PGM=(UHV0032P),SERVICE=13,RMV=LZI1,
FLAGS=C300000000000000
* MOTOR VOTER DELETE VOTER REGISTRATION
PCTEH LV33,PGM=(UHV0033P),RMV=LIMV
* MOTOR VOTER RE-SEND VOTER REGISTRATION INFORMATION
PCTEH LV34,PGM=(UHV0034P),RMV=LIMV
* MOTOR VOTER HISTORY LOOKUP
PCTEH LV40,PGM=(UHV0040P),RMV=LHMV
*
* PEEL IMAGE OFF TO IMAGE UNLOAD DATASET
PCTEH LV50,PGM=(UHV0050P),RMV=LZI1,
FLAGS=C300000000000000,SERVICE=13
*
* ENTRIES UNIQUE TO LX OR THE GHOST:
* GENERALIZED TRANSFER-FILE INQUIRE_STATUS:
PCTEH LXA0,PGM=(UHL0440P),SERVICE=4,RMV=LX
* GENREALIZED TRANSFER-FILE INQUIRE_DETAIL:
PCTEH LXB0,PGM=(UHL0460P),SERVICE=4,RMV=LX
* GENERALIZED TRANSFER-FILE EMULSIFY NO BREF:
PCTEH LXC0,PGM=(UHL0480P),SERVICE=4,RMV=LX,
FLAGS=8000000000000000
* GENERALIZED TRANSFER-FILE EMULSIFY WITH BREF:
PCTEH LXC1,PGM=(UHL0480P,UHL0410P),SERVICE=4,RMV=LX
* GENERALIZED INQUIRE_CDL:
PCTEH LXD0,PGM=(UHL0380P,UHLNDR1P,UHL0410P),SERVICE=4,RMV=LX
* CDLIS OVERRIDE BREF: (1ST 2 FLAG BYTES=SUBFUNCTION SECURITY)
PCTEH LXE0,PGM=(UHL0490P,UHL0410P),SERVICE=4,RMV=LYR,
FLAGS=D640000000000000
*
* GENERALIZED CDL AUTO APPLY:
PCTEH LXF0,PGM=(UHL0430P,UHL0450P,UHL0410P),SERVICE=4,RMV=LX
* GENERALIZED CDL AUTO APPLY:
PCTEH LXF1,PGM=(UHL0430P,UHL0450P,UHL0410P),SERVICE=4,RMV=LX,
FLAGS=8000000000000000
* GENERALIZED CDL MESSAGE CONTROL RECORD REAL TIME SEND CLOCK UPDATE
PCTEH LXG0,PGM=(UHL0450P),SERVICE=4,RMV=LX
* FORMAT PDPS MESSAGE REQUESTS
PCTEH LXP0,PGM=(UHL0600P),SERVICE=26,
RMV=LX
* PDPS PERS-EXT TYPE 6 LOOKUP
PCTEH LXP1,PGM=(UHL0610P),RMV=LI
* PDPS BREF WRITE, PERS-EXT UPDATE
Appendix C – Host Process Control Table
08820000
08830000
08840000
08850000
08860000
08870000
08880000
08890000
X08900000
08910000
08920000
08930000
08940000
08950000
08960000
X08970000
08980000
08990000
09000000
09010000
09020000
09030000
09040000
09050000
09060000
X09070000
09080000
09090000
09100000
09110000
09120000
09130000
09140000
09150000
X09160000
09170000
09180000
09190000
09200000
09210000
09220000
X09230000
09240000
09250000
09260000
09270000
09280000
X09290000
09300000
09310000
09320000
09330000
X09340000
09350000
09360000
09370000
09380000
248
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH LXP2,PGM=(UHL0630P,UHL0620P),SERVICE=4,RMV=LX
* LX UPDATE_DETAIL:
PCTEH LX10,PGM=(UHL0260P,UHL0340P,UHL0400P),SERVICE=4,RMV=LX
* DV0196
* LX UPDATE_DETAIL: SECURED, NOT APPLY NDR MATCH
PCTEH LX11,PGM=(UHL0260P,UHL0340P,UHL0400P),SERVICE=4,RMV=LX,
FLAGS=C440000000000000
* DV0196 END
* LX INQUIRE_DETAIL:
PCTEH LX20,PGM=(UHL0240P),SERVICE=4,RMV=LX
* LX INQUIRE_STATUS:
PCTEH LX40,PGM=(UHL0280P),SERVICE=4,RMV=LX
* LX INQUIRE_NDR:
PCTEH LX50,PGM=(UHL0300P,UHLNDR1P,UHL0400P),SERVICE=4,RMV=LX
* LXGHOST INQUIRE_NDR
PCTEH LX51,PGM=(UHL0300P,UHLNDR1P,UHL0400P),SERVICE=4,RMV=LX,
FLAGS=8000000000000000
* LX EMULSIFY:
PCTEH LX60,PGM=(UHL0320P,UHL0400P),SERVICE=4,RMV=LX
* LXGHOST EMULSIFY:
PCTEH LX61,PGM=(UHL0320P,UHL0400P),SERVICE=4,RMV=LX,
FLAGS=8000000000000000
* LX-WRITE OVERRIDE BREF: (1ST 2 FLAG BYTES=SUBFUNCTION SECURITY)
PCTEH LX70,PGM=(UHL0260P,UHL0400P),SERVICE=4,RMV=LX,
FLAGS=C440000000000000
*
*
* WRITE BREF FROM ALARS WITH NO REAL SECURITY
PCTEH LX71,PGM=(UHL0260P,UHL0400P),SERVICE=4,RMV=LI
*
* WRITE BREF FROM ALARS: (LAST FLAG BYTE = RLC)
PCTEH LX72,PGM=(UHL0260P,UHL0400P),SERVICE=4,RMV=LI,
FLAGS=00000000000000D9
*
* LY HISTORY LOOK-UP BY SSN
PCTEH LY01,PGM=(UHL0090P,UHL0060P),
RMV=LI,DUPKEY=LD04
* STOPPER/ENABLER HOST FUNCTION
*
PCTEH LZ01,PGM=(UHL2999P),RMV=LI
PCTEH LZ02,PGM=(UHL2010P,UHL2000P,UHL2020P),RMV=LI,
SERVICE=22
PCTEH LZ03,PGM=(UHL2010P,UHL2000P,UHL2020P),RMV=UDUP,
SERVICE=22
PCTEH LZ04,PGM=(UHL2010P,UHL2000P,UHL2030P),RMV=LI,
SERVICE=22
* MAB STOPPER/ENABLER HOST
PCTEH LZ05,PGM=(UHL2010P,UHL2000P,UHL2040P),RMV=LI,
SERVICE=22
* MAB STOPPER/ENABLER HOST FOR TEST ONLY
PCTEH LZ06,PGM=(UHL2010P,UHL2000S,UHL2040S),RMV=LI,
SERVICE=22
* MATT INQUIRE ON MATT TEST BED FILE
PCTEH MA01,PGM=(UHT0010P),SERVICE=35,RMV=MATE
* MATT:INCOMPLETE UPDATES TO TESTBED
PCTEH MA02,PGM=(UHT0060P),SERVICE=35,RMV=MATE
* MATT:UPDATE TEST BED "COMPLETE" SWITCH
PCTEH MA03,PGM=(UHT0030P),SERVICE=35,RMV=MATE
Appendix C – Host Process Control Table
09390000
09400000
09410000
09420000
09430000
X09440000
09450000
09460000
09470000
09480000
09490000
09500000
09510000
09520000
09530000
X09540000
09550000
09560000
09570000
09580000
X09590000
09600000
09610000
X09620000
09630000
09640000
09650000
09660000
09670000
09680000
09690000
X09700000
09710000
09720000
09730000
X09740000
09750000
09760000
09770000
X09780000
09790000
X09800000
09810000
X09820000
09830000
09840000
X09850000
09860000
09870000
X09880000
09890000
09900000
09910000
09920000
09930000
09940000
09950000
249
Registry of Motor Vehicles – UMS Programmer’s Manual
* MATT:RETRIEVE LIST OF TEST CASES FROM TESTBED
PCTEH MA04,PGM=(UHT0050P),SERVICE=35,RMV=MATE
* MATT:DELETE TESTBED RECORD
PCTEH MA05,PGM=(UHT0040P),SERVICE=35,RMV=MATE
* MATT:READ TEST BED THEN WRITE MATTIN & UNI TDQ RECORDS
PCTEH MA06,PGM=(UHT0020P),SERVICE=35,RMV=MATE
* MATT:COPY TEST BED RECORD TO CREATE NEW TEST CASE
PCTEH MA07,PGM=(UHT0070P),SERVICE=35,RMV=MATE
* MATT INQUIRE ON MATT OUT FILE
PCTEH MA08,PGM=(UHT0080P),SERVICE=35,RMV=MATV
* MATT INQUIRE ON UNI APPLICATION MESSAGE FILE
PCTEH MA09,PGM=(UHT0090P),SERVICE=35,RMV=MATV
* MAB ADD A COMPLAINT
PCTEH MA20,PGM=(UHH0200P),RMV=MANC,SERVICE=6
* MAB INFORMATION - DELETE A COMPLAINT
PCTEH MA21,PGM=(UHH0210P),RMV=MADN
* MAB INFORMATION - CANCEL HP/DV PLATE
PCTEH MA22,PGM=(UHH0220P),RMV=MACP
* MAB CANCEL PLACARD
PCTEH MA23,PGM=(UHH0230P),RMV=MACP
* MAB GET CUSTOMERS INFORMATION MAB DATA
PCTEH MA25,PGM=(UHH0250P),RMV=APMN
* MAB RETRIEVE CUSTOMER MEDICAL CONDITIONS
PCTEH MA26,PGM=(UHH0260P),SERVICE=44,RMV=MAMI
* MAB UPDATE CUSTOMERS MAB INFORMATION
PCTEH MA27,PGM=(UHH0270P),RMV=MAMI
* MAB INFORMATION - ISSUE HP/DV PLATE
PCTEH MA28,PGM=(UHH0280P),RMV=MAPL
* MAB ISSUE REGULAR OR FOREIGN PLACARD
**
PCTEH MA29,PGM=(UHH0290P),SERVICE=28,RMV=MAPL
PCTEH MA29,PGM=(UHH0290P),SERVICE=44,RMV=MAPL
* MAB PRINT PLACARD
PCTEH MA30,PGM=(UHH0300P),RMV=MAPL
* MAB NOTES INQUIRY
PCTEH MA31,PGM=(UHH0310P),RMV=MATL
* MAB NOTES ADD
PCTEH MA32,PGM=(UHH0320P),RMV=MATL
* MAB RETRIEVE PLACARD TRIGGERS
PCTEH MA33,PGM=(UHH0330P),SERVICE=44
* MAB OVERRIDE
PCTEH MA34,PGM=(UHH0340P),RMV=MAOV
* MAB UPDATE PLACARD TRIGGERS
PCTEH MA35,PGM=(UHH0350P)
* MAB RESOLVE NOT STO COMPLAINT
PCTEH MA36,PGM=(UHH0360P),RMV=MANC
* MAB TRANSACTION LOG INQUIRY
PCTEH MA37,PGM=(UHH0370P),RMV=MATL
* MAB INFORMATION - GET HEALTHCARE PRVDR SURR BY REG#
PCTEH MA38,PGM=(UHH0380P),RMV=MAMI
* MAB REQUEST LETTER
PCTEH MA39,PGM=(UHH0390P)
* MAB IDENTIFY CUSTOMER BY PLATE TYPE AND NUMBER
PCTEH MA40,PGM=(UHH0400P),DUPKEY=UR05,RMV=APMN
* MAB GET ALL HEALTHCARE PROVIDERS FOR A REGISTRATION
PCTEH MA41,PGM=(UHH0410P),RMV=MAMI
* MAB ADD HEALTHCARE PRIVIDER
PCTEH MA42,PGM=(UHH0420P),RMV=MAMI
Appendix C – Host Process Control Table
09960000
09970000
09980000
09990000
10000000
10010000
10020000
10030000
10040000
10050000
10060000
10070000
10080000
10090000
10100000
10110000
10120000
10130000
10140000
10150000
10160000
10170000
10180000
10190000
10200000
10210000
10220000
10230000
10240000
10250000
10260000
10270000
10280000
10290000
10300000
10310000
10320000
10330000
10340000
10350000
10360000
10370000
10380000
10390000
10400000
10410000
10420000
10430000
10440000
10450000
10460000
10470000
10480000
10490000
10500000
10510000
10520000
250
Registry of Motor Vehicles – UMS Programmer’s Manual
* MAB INFORMATION - UNDO APPROVAL
PCTEH MA44,PGM=(UHH0440P),RMV=MAOV
* MAB INFORMATION - MULTIPLE PLATE LIST
PCTEH MA45,PGM=(UHH0450P),RMV=MAPL
* MAB INFORMATION - GET HEALTHCARE PRVDR DATA BY SURR
PCTEH MA47,PGM=(UHH0470P),RMV=MAMI
* MAB RENEW, REPLACE OR EXTEND PLACARD
PCTEH MA48,PGM=(UHH0480P),SERVICE=28,RMV=MAPL
* MAB RETRIEVE UNPRINTED PLACARD TRIGGERS
PCTEH MA49,PGM=(UHH0490P),SERVICE=44
* MAB STOPPER LETTER CODE LOOK-UP
PCTEH MA50,PGM=(UHH0500P)
* MAB RETRIEVE PLACARD DATA FOR PLACARD PRINTING
PCTEH MA51,PGM=(UHH0510P)
* MAB INFORMATION - GET REFERENCE DOCUMENT DATA
PCTEH MA52,PGM=(UHH0520P),RMV=MAMI
* MAB INFORMATION - CREATE PLACARD FOR PENDING TRIGGER RECS
PCTEH MA53,PGM=(UHH0530P),SERVICE=44
* MAB INFORMATION - READ DISABLED PLATES
PCTEH MA54,PGM=(UHH0540P),RMV=MAPL
* MAB - CHECK FOR EXISTING PLATE IN MAB AND ALARS
PCTEH MA55,PGM=(UHH0550P)
* MAB - ISSUE RENEW CANCEL MEDICAL WAIVER
PCTEH MA56,PGM=(UHH0560P)
* MAB - OBSOLETE FUNCTION
PCTEH MA58,PGM=(UHH0580P)
* MAB - ISSUE MAB AGREEMENT
PCTEH MA60,PGM=(UHH0600P),SERVICE=46
* MAB - UPDATE MAB AGREEMENT
PCTEH MA61,PGM=(UHH0610P)
* MAB - CLOSE MAB AGREEMENT
PCTEH MA62,PGM=(UHH0620P)
* MAB - DELETE MAB AGREEMENT
PCTEH MA63,PGM=(UHH0630P)
* MAB - RETRIEVE MULTIPLE MAB AGREEMENTS
PCTEH MA64,PGM=(UHH0640P)
* MAB - RETRIEVE A SINGLE MAB AGREEMENT
PCTEH MA65,PGM=(UHH0650P)
* MAB - UPDATE LETTER TEXT
PCTEH MA66,PGM=(UHH0660P)
* MRB DUPLICATE LICENSE SCROLL
PCTEH MRBX,PGM=(UHM0002P),RMV=MO
* RETRIEVE OPERATOR LICENSE INFORMATION (MRB)
PCTEH MRB0,PGM=(UHM0001P),DUPKEY=MRBX,RMV=MO
* MRB CUSTOMER SERVICE INQUIRY
PCTEH MS01,PGM=(UHM0060P)
* MRB CUSTOMER SERVICE UPDATE
PCTEH MS02,PGM=(UHM0062P)
* NMH
NMVTIS MESSAGES LOG SCREEN
PCTEH NM01,PGM=(UHR1363P),RMV=NMH
* NEW PASSWORD, PASSWORD CHANGER
PCTEH NP20,PGM=(UHZ0018P,UHZ0105P),RMV=CMC
* NONRENEW, GENERAL ADDRESS EDIT, FULL FUNCTION
PCTEH NRAE,PGM=UHN0160P,RMV=NRAE
* NONRENEW, GENERAL ADDRESS EDIT, UGZ0006P ONLY
PCTEH NRAF,PGM=UHN0160P,RMV=NRAE,FLAGS=0100000000000000
* NONRENEW STATUS
Appendix C – Host Process Control Table
10530000
10540000
10550000
10560000
10570000
10580000
10590000
10600000
10610000
10620000
10630000
10640000
10650000
10660000
10670000
10680000
10690000
10700000
10710000
10720000
10730000
10740000
10750000
10760000
10770000
10780000
10790000
10800000
10810000
10820000
10830000
10840000
10850000
10860000
10870000
10880000
10890000
10900000
10910000
10920000
10930000
10940000
10950000
10960000
10970000
10980000
10990000
11000000
11010000
11020000
11030000
11040000
11050000
11060000
11070000
11080000
11090000
251
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH NRA0,PGM=UHN0100P,RMV=NRL
* NONRENEW, GENERAL ADDRESS EDIT, FULL FUNCTION 40 BYTE
PCTEH NRBE,PGM=UHN0161P,RMV=NRAE
* NONRENEW, GENERAL ADDRESS EDIT, UGZ0006P ONLY 40 BYTE
PCTEH NRBF,PGM=UHN0161P,RMV=NRAE,FLAGS=0100000000000000
* NONRENEW WARRANT INQUIRY
PCTEH NR18,PGM=UHN0180P
* NONRENEW WARRANT INQUIRY FOR EXEMPT
PCTEH NR19,PGM=UHN0180P,FLAGS=C500000000000000
* NONRENEW TICKET# INQUIRY
PCTEH NR20,PGM=(UHN0020P,UHN0100P),RMV=NRL
* NONRENEW WARRANT APPLY AND CLEAR EXEMPTION
PCTEH NR22,PGM=(UHN0220P),RMV=LWAX
* NONRENEW WARRANT EXEMPTION INQUIRY
PCTEH NR24,PGM=(UHN0240P),RMV=LWIX
* NONRENEW TICKET CALCULATION COST
PCTEH NR30,PGM=(UHN0310P)
* NONRENEW INDEXED TICKET INQUIRY
PCTEH NR40,PGM=(UHN0040P,UHN0100P),RMV=NRL
* NONRENEW INDEXED TICKET INQUIRY WITH TOWN/SUBSYS
PCTEH NR41,PGM=(UHN0040P,UHN0100P),RMV=NRL,
FLAGS=0100000000000000
* NONRENEW INDEXED CLEAR TICKET INQUIRY
PCTEH NR42,PGM=(UHN0120P,UHN0100P),RMV=NRL
* NONRENEW INDEXED CLEAR TICKET INQUIRY
PCTEH NR43,PGM=(UHN0140P,UHN0100P),RMV=NRL
* NONRENEW SWAP INQUIRY
PCTEH NR60,PGM=(UHN0060P,UHN0300P),RMV=NRL
* NONRENEW UPDATE, MARK FUNCTION
PCTEH NR80,PGM=(UHN0080P,UHN0300P),RMV=NRM
* NONRENEW UPDATE, CLEAR FUNCTION
PCTEH NR81,PGM=(UHN0080P,UHN0300P),RMV=NRC
* NONRENEW UPDATE, CHANGE TICKET NUMBER FUNCTION
PCTEH NR82,PGM=(UHN0080P,UHN0300P),RMV=NRX
* NONRENEW UPDATE, MARK FUNCTION (EXTERNAL)
PCTEH NR83,PGM=(UHN0080P,UHN0300P),RMV=NRMX,
FLAGS=E700000000000000
* NONRENEW UPDATE, CLEAR FUNCTION (EXTERNAL)
PCTEH NR84,PGM=(UHN0080P,UHN0300P),RMV=NRC,
FLAGS=E700000000000000
* NONRENEW UPDATE, CHANGE NUMBER FUNCTION (EXTERNAL)
PCTEH NR85,PGM=(UHN0080P,UHN0300P),RMV=NRX,
FLAGS=E700000000000000
* NONRENEW UPDATE / WARRANT EXCLUSION UPDATE
PCTEH NR99,PGM=(UHN0420P),RMV=NRM
* SOA - OOS ACCIDENTS (INQ BY MA LICENSE NUMBER)
PCTEH OA01,PGM=(UHS1173P),RMV=SOA,DUPKEY=LI04,SERVICE=9
* SOA - OOS ACCIDENTS (INQ BY OOS LICENSE NUMBER)
PCTEH OA02,PGM=(UHS1173P),RMV=SOA,DUPKEY=LD08,SERVICE=9
* SOA - OOS ACCIDENTS (UPDATE OUT OF STATE ACCIDENT)
PCTEH OA03,PGM=(UHS1174P),RMV=SOA
*
* SOC - OOS CONVICTIONS (INQ BY MA LICENSE NUMBER)
PCTEH OC01,PGM=(UHS1153P),RMV=SOC,DUPKEY=LI04,SERVICE=9
* SOC - OOS CONVICTIONS (INQ BY OOS LICENSE NUMBER)
PCTEH OC02,PGM=(UHS1153P),RMV=SOC,DUPKEY=LD08,SERVICE=9
* SOC - OOS CONVICTIONS (UPDATE OUT OF STATE CONVICTION)
Appendix C – Host Process Control Table
11100000
11110000
11120000
11130000
11140000
11150000
11160000
11170000
11180000
11190000
11200000
11210000
11220000
11230000
11240000
11250000
11260000
11270000
11280000
11290000
X11300000
11310000
11320000
11330000
11340000
11350000
11360000
11370000
11380000
11390000
11400000
11410000
11420000
11430000
11440000
X11450000
11460000
11470000
X11480000
11490000
11500000
X11510000
11520000
11530000
11540000
11550000
11560000
11570000
11580000
11590000
11600000
11610000
11620000
11630000
11640000
11650000
11660000
252
Registry of Motor Vehicles – UMS Programmer’s Manual
PCTEH OC03,PGM=(UHS1154P),RMV=SOC,SERVICE=9
* SOC - OOS CONVICTIONS (INQ BY MA LICENSE NUMBER)
PCTEH OC04,PGM=(UHS2153P),RMV=SOC,DUPKEY=LI04,SERVICE=9
* SOC - OOS CONVICTIONS (INQ BY OOS LICENSE NUMBER)
PCTEH OC05,PGM=(UHS2153P),RMV=SOC,DUPKEY=LD08,SERVICE=9
* SOC - OOS CONVICTIONS (UPDATE OUT OF STATE CONVICTION)
PCTEH OC06,PGM=(UHS2154P),RMV=SOC,SERVICE=9
* SOC - OOS CONVICTIONS (INQ BY MA LICENSE NUMBER)
PCTEH OC07,PGM=(UHS3153P),RMV=SOC,DUPKEY=LI04,SERVICE=9
* SOC - OOS CONVICTIONS (INQ BY OOS LICENSE NUMBER)
PCTEH OC08,PGM=(UHS3153P),RMV=SOC,DUPKEY=LD08,SERVICE=9
* SOC - OOS CONVICTIONS (UPDATE OUT OF STATE CONVICTION)
PCTEH OC09,PGM=(UHS3154P),RMV=SOC,SERVICE=9
*
* SOW - OOS WITHDRAWALS (INQ BY MA LICENSE NUMBER)
PCTEH OW01,PGM=(UHS1163P),RMV=SOW,DUPKEY=LI04,SERVICE=9
* SOW - OOS WITHDRAWALS (INQ BY OOS LICENSE NUMBER)
PCTEH OW02,PGM=(UHS1163P),RMV=SOW,DUPKEY=LD08,SERVICE=9
* SOW - OOS WITHDRAWALS (UPDATE OUT OF STATE WITHDRAWAL)
PCTEH OW03,PGM=(UHS1164P),RMV=SOW
* OWI - COMMERCIAL VEHICLE OVERWEIGHT INQUIRY
PCTEH OW04,PGM=(UHW1143Q),RMV=OWI
* OWH - COMMERCIAL VEHICLE OVERWEIGHT HISTORY
PCTEH OW05,PGM=(UHW1133Q),RMV=OWH
*
* UPA - POLICY AMEND (INQ BY POLICY ID)
(NEW)
PCTEH PA05,PGM=(UHU2123P),RMV=UPA,SERVICE=1
* UPA - POLICY AMEND (INQ BY MA LICENSE NUMBER)
(NEW)
PCTEH PA06,PGM=(UHU2123P),RMV=UPA,DUPKEY=LI04,SERVICE=1
* UPA - POLICY AMEND (INQ BY OOS LICENSE NUMBER) (NEW)
PCTEH PA07,PGM=(UHU2123P),RMV=UPA,DUPKEY=LD08,SERVICE=1
* UPA - POLICY AMEND (UPDATE POLICY INFO)
(NEW)
PCTEH PA08,PGM=(UHU2124P),RMV=UPA,SERVICE=1
* UPMV - MULTIPLE VEHICLE AMEND SCREEN
PCTEH PA09,PGM=(UHU1143P),RMV=UPMV
* UPA - POLICY AMEND (INQ BY POLICY ID)
PCTEH PA10,PGM=(UHU3123P),RMV=UPA,SERVICE=1
* UPA - POLICY AMEND (INQ BY MA LICENSE NUMBER)
PCTEH PA11,PGM=(UHU3123P),RMV=UPA,DUPKEY=LI04,SERVICE=1
* UPA - POLICY AMEND (INQ BY OOS LICENSE NUMBER)
PCTEH PA12,PGM=(UHU3123P),RMV=UPA,DUPKEY=LD08,SERVICE=1
* UPA - POLICY AMEND (UPDATE POLICY INFO)
PCTEH PA13,PGM=(UHU3124P),RMV=UPA,SERVICE=1
* UPA - POLICY AMEND (INQ BY FID)
PCTEH PA14,PGM=(UHU3123P),RMV=UPA,DUPKEY=UR09,SERVICE=1
* CPB - BACKOUT TRANSACTIONS
PCTEH PB01,PGM=(UHC1063P),RMV=CPB
* CPG - CASH PROCESS - GENERAL COLLECTION (INQ BY MA LICENSE NUMBER)
PCTEH PG01,PGM=(UHC1053P),RMV=CPG,DUPKEY=LI04,SERVICE=52
* CPG - CASH PROCESS - GENERAL COLLECTION (INQ BY OOS LICENSE NUMBER)
PCTEH PG02,PGM=(UHC1053P),RMV=CPG,DUPKEY=LD08,SERVICE=52
* CPG - CASH PROCESS - GENERAL COLLECTION (INQ BY REG)
PCTEH PG03,PGM=(UHC1053P),RMV=CPG,DUPKEY=UR05,SERVICE=52
* CPG - CASH PROCESS - GENERAL COLLECTION (UPDATE PROCESS)
PCTEH PG04,PGM=(UHC1054P),RMV=CPG,SERVICE=52
* OVERWEIGHT REDUCIBLE PERMIT ISSUANCE SCREEN
Appendix C – Host Process Control Table
11670000
11680000
11690000
11700000
11710000
11720000
11730000
11740000
11750000
11760000
11770000
11780000
11790000
11800000
11810000
11820000
11830000
11840000
11850000
11860000
11870000
11880000
11890000
11900000
11910000
11920000
11930000
11940000
11950000
11960000
11970000
11980000
11990000
12000000
12010000
12020000
12030000
12040000
12050000
12060000
12070000
12080000
12090000
12100000
12110000
12120000
12130000
12140000
12160000
12170000
12180000
12190000
12200000
12210000
12220000
12230000
12260000
253
Registry of Motor Vehicles – UMS Programmer’s Manual
* OW - PERMIT ISSUE (INQ BY REG)
PCTEH PI01,PGM=(UHW1113P),RMV=OW,DUPKEY=UR05
* OW - PERMIT ISSUE (INQ BY VIN)
PCTEH PI02,PGM=(UHW1113P),RMV=OW,DUPKEY=UR03
* OW - PERMIT ISSUE (LIC INQUIRY)
PCTEH PI03,PGM=(UHW1113P),RMV=OW,DUPKEY=LI04
* UPDATE PASSENGER RESTRICTION DATA
PCTEH PR02,PGM=(UHL3202P),RMV=LPRM,SERVICE=18
* RETRIEVE PASSENGER RESTRICTION DATA
PCTEH PR04,PGM=(UHL3204P)
* PASSENGER RESTRICTION INQUIRY
PCTEH PR05,PGM=(UHL3205P)
* JOL STATUS INQUIRY
PCTEH PR06,PGM=(UHL3206P)
* RA - REG AMEND (INQ BY REG)
PCTEH RA01,PGM=(UHR1273P),RMV=RA,DUPKEY=UR05,
SERVICE=1
* RA - REG AMEND (INQ BY VIN)
PCTEH RA02,PGM=(UHR1273P),RMV=RA,DUPKEY=UR03,
SERVICE=1
* RA - REG AMEND (LIC INQUIRY)
PCTEH RA03,PGM=(UHR1273P),RMV=RA,DUPKEY=LI04,
SERVICE=1
* STOLEN VEHICLE UPDATES (STOLEN/RECOVERED VEHICLE/PLATES)
PCTEH RC02,PGM=(UHR1293P,UHR1294P),RMV=RC
* REGISTRATION HISTORY INQUIRY
PCTEH RH01,PGM=(UHR1253P),RMV=RH,SERVICE=9
* REGISTRATION STORE/MODIFY/ERASE MMVR-VEHR-ADDR
PCTEH RI20,PGM=(UHR0020P)
* REGISTRATION SCROLL BY NUMBER
PCTEH RN01,PGM=(UHR0010P),RMV=RN,SERVICE=1
* RP - VANITY/SPECIAL PLATE ORDER
PCTEH RP00,PGM=(UHR0313P),RMV=RP
* REGISTRATION SUPERQUERY. SC0197.
PCTEH RSQ1,PGM=(UHR0040P,UHR0060P),RMV=RS
* R1A - RMV-1 RX/SW ACTIONS
*
PCTEH R101,PGM=(UHR1183P),RMV=R1A,DUPKEY=LI03
* R1A - RMV-1 RO/RT ACTIONS
*
PCTEH R102,PGM=(UHR1184P),RMV=R1A,DUPKEY=LI03
* R1A - RMV-1 TO/ST ACTIONS
*
PCTEH R103,PGM=(UHR1185P),RMV=R1A,DUPKEY=LI03
* R1A - RMV-1 RX/SW ACTIONS
PCTEH R101,PGM=(UHR1183P),RMV=TR1A,SERVICE=1 EDIT=FORCE
* R1A - RMV-1 RO/RT ACTIONS
PCTEH R102,PGM=(UHR1184P),RMV=TR1A EDIT=FORCE
* R1A - RMV-1 TO/ST ACTIONS
PCTEH R103,PGM=(UHR1185P),RMV=TR1A EDIT=FORCE
* R1B - RMV-1 RX/SW/RO/RT/TO/ST ACTIONS
PCTEH R104,PGM=(UHR1193P),RMV=TR1B
* R1A - RMV-1 RX/SW ACTIONS
PCTEH R111,PGM=(UHR2183P),RMV=R1A,SERVICE=1 EDIT=FORCE
* R1A - RMV-1 RO/RT ACTIONS
PCTEH R112,PGM=(UHR2184P),RMV=R1A EDIT=FORCE
* R1A - RMV-1 TO/ST ACTIONS
PCTEH R113,PGM=(UHR2185P),RMV=R1A EDIT=FORCE
* R1B - RMV-1 RX/SW/RO/RT/TO/ST/SS ACTIONS
PCTEH R114,PGM=(UHR2193P),RMV=R1B
Appendix C – Host Process Control Table
12270000
12280000
12290000
12300000
12310000
12320000
12340000
12350000
12360000
12370000
12380000
12390000
12400000
12410000
12420000
X12430000
12440000
12450000
X12460000
12470000
12480000
X12490000
12500000
12510000
12520000
12530000
12540000
12550000
12560000
12570000
12580000
12590000
12600000
12610000
12620000
12670000
12680000
12690000
12700000
12710000
12720000
12730000
12740000
12750000
12760000
12770000
12780000
12790000
12800000
12810000
12820000
12830000
12840000
12850000
12860000
12870000
12880000
254
Registry of Motor Vehicles – UMS Programmer’s Manual
* R1A - RMV-1 SS ACTION
PCTEH R115,PGM=(UHR2187P),RMV=R1A EDIT=FORCE
* R1C - IN CUSTODY LESSEE INFORMATION
PCTEH R116,PGM=(UHR2303P),RMV=R1C
* EVRR - EVR RESEND RESPONSE SCREEN
PCTEH R117,PGM=(UHR1173P),RMV=EVRR
* SUSPENSIONS DRIVER HISTORY INQUIRY (BY MA LICENSE NUMBER)
PCTEH SDH0,PGM=(UHL0070P,UHL0100P),SERVICE=6,
RMV=SDH,DUPKEY=LI04
* SUSPENSIONS DRIVER HISTORY INQUIRY (BY OOS LICENSE NUMBER)
PCTEH SDH1,PGM=(UHL0080P,UHL0100P),SERVICE=6,
RMV=SDH,DUPKEY=LD08
* SUSPENSIONS DRIVER HISTORY INQUIRY (BY SOCIAL SECURITY NO)
PCTEH SDH2,PGM=(UHL0090P,UHL0100P),SERVICE=6,
RMV=SDH,DUPKEY=LD04
* SUSPENSIONS DRIVER HISTORY INQUIRY (PERSON SURROGATE)
PCTEH SDH3,PGM=(UHL0100P),SERVICE=6,
RMV=SDH
* SUSPENSIONS DRIVER HISTORY INQUIRY (OBTAINING UNOP DATA)
PCTEH SDH4,PGM=(UHS1103P),SERVICE=6,
RMV=SDH
* SUSPENSIONS DRIVER HISTORY INQUIRY (READ OUTBOUND TRANSFER FILE)
PCTEH SDH5,PGM=(UHS1104P),SERVICE=6,
RMV=SDH
*
* PRINT DEMOGRAPHICS SUB-FUNCTION SECURITY
PCTEH SECR,PGM=(UHL1120P)
*
PCTEH SEC1,PGM=(UHR1993P),SERVICE=1,RMV=RI
*
* APW MAIN MENU SECURITY
PCTEH SEC2,PGM=(UHL1150P),RMV=APMN
*
* SUSPENSION HISTORY BY LIC NUMBER
PCTEH SH01,PGM=(UHSI100P,UHSO100P),RMV=SH,DUPKEY=LI04,
SERVICE=2
* SUSPENSION HISTORY BY SURROGATE
PCTEH SH02,PGM=(UHSO100P),RMV=SH,SERVICE=2
* SUSPENSION HISTORY BY LIC NUMBER (NEW)
PCTEH SH03,PGM=(UHL0070P,UHS1054P),RMV=SH,DUPKEY=LI04,
SERVICE=25
* SUSPENSION HISTORY BY SURROGATE (NEW)
PCTEH SH04,PGM=(UHS1054P),RMV=SH,SERVICE=25
* SUSPENSION HISTORY BY OOS NUMBER (NEW)
PCTEH SH05,PGM=(UHL0080P,UHS1054P),RMV=SH,DUPKEY=LD08,
SERVICE=25
********************************************************************
* END OF REMOVAL OF NO LONGER USED SH FUNCTIONS
********************************************************************
* SUSPENSION HISTORY BY LIC NUMBER (NEW)
PCTEH SH06,PGM=(UHL0070P,UHS2054P),RMV=SH,DUPKEY=LI04,
SERVICE=9
* SUSPENSION HISTORY BY SURROGATE (NEW)
PCTEH SH07,PGM=(UHS2054P),RMV=SH,SERVICE=9
* SUSPENSION HISTORY BY OOS NUMBER (NEW)
PCTEH SH08,PGM=(UHL0080P,UHS2054P),RMV=SH,DUPKEY=LD08,
SERVICE=9
Appendix C – Host Process Control Table
12890000
12900000
12910000
12920000
12930000
12940000
12950000
X12960000
12970000
12980000
X12990000
13000000
13010000
X13020000
13030000
13040000
X13050000
13060000
13070000
X13080000
13090000
13100000
X13110000
13120000
13130000
13140000
13150000
13160000
13170000
13180000
13190000
13200000
13210000
13220000
X13230000
13240000
13250000
13260000
13310000
X13320000
13330000
13340000
13350000
13360000
X13370000
13380000
13390000
13400000
13410000
13420000
X13430000
13440000
13450000
13460000
13470000
X13480000
13490000
255
Registry of Motor Vehicles – UMS Programmer’s Manual
* SUSPENSION HISTORY BY REG (NEW)
PCTEH SH09,PGM=(UHS2053P,UHS2054P),RMV=SH,DUPKEY=UR05,
SERVICE=9
* SUSPENSION HISTORY BY LIC NUMBER (NEW)
PCTEH SH10,PGM=(UHL0070P,UHS3054P),RMV=SH,DUPKEY=LI04,
SERVICE=9
* SUSPENSION HISTORY BY SURROGATE (NEW)
PCTEH SH11,PGM=(UHS3054P),RMV=SH,SERVICE=9
* SUSPENSION HISTORY BY OOS NUMBER (NEW)
PCTEH SH12,PGM=(UHL0080P,UHS3054P),RMV=SH,DUPKEY=LD08,
SERVICE=9
* SUSPENSION HISTORY BY REG (NEW)
PCTEH SH13,PGM=(UHS3053P,UHS3054P),RMV=SH,DUPKEY=UR05,
SERVICE=9
* SCHEDULE MAINTENANCE CALENDAR INQUIRY
PCTEH SMCI,PGM=(UHB2200P),FLAGS=C900000000000000 ,RMV=
* SCHEDULE MAINTENANCE CALENDAR UPDATE
PCTEH SMCU,PGM=(UHB2200P),FLAGS=E400000000000000 ,RMV=
* SSOLV OUTBOUND INQUIRY HOST
PCTEH SS01,PGM=(UHL3400P)
* SSOLV - RETRIEVE SSA RESPONSE FROM RAD FILE
PCTEH SS02,PGM=(UHL0870P)
* SSOLV - RESEND PROCESSING
PCTEH SS03,PGM=(UHL3430P)
* SSOLV - SSN STATUS HOST
PCTEH SS04,PGM=(UHL3440P)
* ADDED 05/02/96
* SUSPENSIONS OUI UPDATES (INSTATE ADM AND CTR)
PCTEH SU01,PGM=(UHS1183P,UHS1184P),RMV=SO
* UTAS TITLE AUDIT SCREEN
PCTEH TAS1,PGM=UHR1083P,RMV=TAS
* ALOG HISTORY INQUIRY BY REGISTRATION
PCTEH TX01,PGM=(UHR1283P),RMV=TXH,DUPKEY=UR05
* ALOG HISTORY INQUIRY BY TITLE
PCTEH TX02,PGM=(UHR1283P),RMV=TXH
* T1A - TITLE AMEND (INQ BY TITLE/BATCH NUMBER - UPDATE TITLE)
PCTEH T1A1,PGM=(UHR1213P),RMV=T1A,SERVICE=1
* T1A - TITLE AMEND (INQ BY REG)
PCTEH T1A2,PGM=(UHR1213P),RMV=T1A,DUPKEY=UR05,SERVICE=1
* T1A - TITLE AMEND (INQ BY VIN)
PCTEH T1A3,PGM=(UHR1213P),RMV=T1A,DUPKEY=UR03,SERVICE=1
* T1A - TITLE AMEND (LIEN INQUIRY)
PCTEH T1A4,PGM=(UHR1213P),RMV=T1A,DUPKEY=BS02,SERVICE=1
* T1B - TITLE AMEND CASH (FTAB INQUIRY - UPDATE TITLE)
*DV1192 PCTEH T1B1,PGM=(UHR1223P),RMV=T1B
PCTEH T1B1,PGM=(UHR1223P),RMV=T1A
* T1C - ALTERNATE ADDRESS INFORMATION
PCTEH T1C1,PGM=(UHR1313P),RMV=T1C
* MRB AT-FAULT CLAIM INQUIRY
PCTEH UMA1,PGM=(UHM0030P),RMV=MA
* MRB ADMINISTRATIVE DETAIL
PCTEH UMB1,PGM=(UHM0150P),RMV=MB
* MRB CITATION BATCH CONTROL
PCTEH UMB2,PGM=(UHM0151P),RMV=MV
* MRB COMPREHENSIVE CLAIM INQUIRY
PCTEH UMC1,PGM=(UHM0040P),RMV=MC
Appendix C – Host Process Control Table
13500000
X13510000
13520000
13530000
X13540000
13550000
13560000
13570000
13580000
X13590000
13600000
13610000
X13620000
13630000
13640000
13650000
13660000
13670000
13680000
13690000
13700000
13710000
13720000
13730000
13740000
13750000
13760000
13770000
13780000
13790000
13800000
13810000
13820000
13830000
13840000
13850000
13860000
13870000
13880000
13890000
13900000
13910000
13920000
13930000
13940000
13950000
13960000
13970000
13980000
13990000
14000000
14010000
14020000
14030000
14040000
14050000
14060000
256
Registry of Motor Vehicles – UMS Programmer’s Manual
* MRB DRIVING HISTORY
PCTEH UMDX,PGM=(UHM0090P),RMV=MDH
* MRB ADMINISTRATIVE DETAIL
PCTEH UMDY,PGM=(UHM0094P),RMV=MDD
* MRB RETRIEVE CURRENT SDIP INFORMATION
PCTEH UMI1,PGM=(UHM0020P),RMV=MI9
* MRB RETRIEVE SDIP INQUIRY HISTORY
PCTEH UMI2,PGM=(UHM0021P),RMV=MI9
* MRB SDIP INQUIRY UPDATE
PCTEH UMI3,PGM=(UHM0022P),RMV=MI9
* MRB NO CREDIT PERIOD MAINTENANCE
PCTEH UMNC,PGM=(UHM0012P)
* RETRIEVE OPERATOR SUMMARY INFORMATION (MRB)
PCTEH UMO1,PGM=(UHM0010P),RMV=MO
* MRB DUPLICATE LICENSE SCROLL
PCTEH UMVX,PGM=(UHM0055P),RMV=MVI
* MRB CITATION INQUIRY
PCTEH UMV1,PGM=(UHM0050P),DUPKEY=UMVX,RMV=MVI
* MRB CITATION UPDATE
PCTEH UMV2,PGM=(UHM0250P),DUPKEY=UMVX,RMV=MV
* REGISTRATION INQUIRY BY REG NUMBER (NEW)
PCTEH URIA,PGM=(UHR3063P,UHR3067P),RMV=RI,DUPKEY=UR05,
SERVICE=1
* REGISTRATION INQUIRY BY VIN NUMBER (NEW)
PCTEH URIB,PGM=(UHR3064P,UHR3067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
* REGISTRATION INQUIRY BY LIC NUMBER (NEW)
PCTEH URIC,PGM=(UHR3065P,UHR3067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
* REGISTRATION INQUIRY BY TITLE NUMBER (NEW)
PCTEH URID,PGM=(UHR3066P,UHR3067P),RMV=RI,SERVICE=1
************************************************************
* ADD VER 3 HOST FUNCTION FOR RI INQUIRY BY SURR
************************************************************
* REGISTRATION INQUIRY BY SURROGATE NUMBER
PCTEH URIE,PGM=(UHR3067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY REG NUMBER (VERSION 4)
PCTEH URIF,PGM=(UHR4063P,UHR4067P),RMV=RI,DUPKEY=UR05,
SERVICE=1
*
* REGISTRATION INQUIRY BY VIN NUMBER (VERSION 4)
PCTEH URIG,PGM=(UHR4064P,UHR4067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
*
* REGISTRATION INQUIRY BY LIC NUMBER (VERSION 4)
PCTEH URIH,PGM=(UHR4065P,UHR4067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
*
* REGISTRATION INQUIRY BY TITLE NUMBER (VERSION 4)
PCTEH URII,PGM=(UHR4066P,UHR4067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY SURROGATE NUMBER (VERSION 4)
PCTEH URIJ,PGM=(UHR4067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY REG NUMBER (VERSION 5)
PCTEH URIK,PGM=(UHR5063P,UHR5067P),RMV=RI,DUPKEY=UR05,
Appendix C – Host Process Control Table
14070000
14080000
14090000
14100000
14110000
14120000
14130000
14140000
14150000
14160000
14170000
14180000
14190000
14200000
14210000
14220000
14230000
14240000
14250000
14260000
14270000
X14280000
14290000
14300000
X14310000
14320000
14330000
X14340000
14350000
14360000
14370000
14380000
14390000
14400000
14410000
14420000
14430000
14440000
X14450000
14460000
14470000
14480000
X14490000
14500000
14510000
14520000
X14530000
14540000
14550000
14560000
14570000
14580000
14590000
14600000
14610000
14620000
X14630000
257
Registry of Motor Vehicles – UMS Programmer’s Manual
SERVICE=1
*
* REGISTRATION INQUIRY BY VIN NUMBER (VERSION 5)
PCTEH URIL,PGM=(UHR5064P,UHR5067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
*
* REGISTRATION INQUIRY BY LIC NUMBER (VERSION 5)
PCTEH URIM,PGM=(UHR5065P,UHR5067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
*
* REGISTRATION INQUIRY BY TITLE NUMBER (VERSION 5)
PCTEH URIN,PGM=(UHR5066P,UHR5067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY SURROGATE NUMBER (VERSION 5)
PCTEH URIO,PGM=(UHR5067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY REG NUMBER (VERSION 6)
PCTEH URIP,PGM=(UHR6063P,UHR6067P),RMV=RI,DUPKEY=UR05,
SERVICE=1
*
* REGISTRATION INQUIRY BY VIN NUMBER (VERSION 6)
PCTEH URIQ,PGM=(UHR6064P,UHR6067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
*
* REGISTRATION INQUIRY BY LIC NUMBER (VERSION 6)
PCTEH URIR,PGM=(UHR6065P,UHR6067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
*
* REGISTRATION INQUIRY BY TITLE NUMBER (VERSION 6)
PCTEH URIS,PGM=(UHR6066P,UHR6067P),RMV=RI,SERVICE=1
*
* REGISTRATION INQUIRY BY SURROGATE NUMBER (VERSION 6)
PCTEH URIT,PGM=(UHR6067P),RMV=RI,SERVICE=1
*
*
************************************************************
* VER 2 HOST FUNCTION FOR RI INQUIRY BY SURR
************************************************************
* REGISTRATION INQUIRY BY SURROGATE NUMBER
PCTEH URI0,PGM=(UHR2067P),RMV=RI,SERVICE=1
* REGISTRATION INQUIRY BY REG NUMBER (NEW)
PCTEH URI1,PGM=(UHR2063P,UHR2067P),RMV=RI,DUPKEY=UR05,
SERVICE=1
* REGISTRATION INQUIRY BY VIN NUMBER (NEW)
*
PCTEH URI2,PGM=(UHR1064P,UHR2067P),RMV=RI,DUPKEY=UR03,
PCTEH URI2,PGM=(UHR2064P,UHR2067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
* REGISTRATION INQUIRY BY LIC NUMBER (NEW)
*
PCTEH URI3,PGM=(UHR1065P,UHR2067P),RMV=RI,DUPKEY=LI04,
PCTEH URI3,PGM=(UHR2065P,UHR2067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
* REGISTRATION INQUIRY BY TITLE NUMBER (NEW)
*
PCTEH URI4,PGM=(UHR1066P,UHR2067P),RMV=RI,SERVICE=1
PCTEH URI4,PGM=(UHR2066P,UHR2067P),RMV=RI,SERVICE=1
* REGISTRATION INQUIRY BY REG NUMBER
PCTEH URI5,PGM=(UHR1063P,UHR1067P),RMV=RI,DUPKEY=UR05,
SERVICE=1
Appendix C – Host Process Control Table
14640000
14650000
14660000
X14670000
14680000
14690000
14700000
X14710000
14720000
14730000
14740000
14750000
14760000
14770000
14780000
14790000
14800000
X14810000
14820000
14830000
14840000
X14850000
14860000
14870000
14880000
X14890000
14900000
14910000
14920000
14930000
14940000
14950000
14960000
14970000
14980000
14990000
15000000
15010000
15020000
15030000
15040000
X15050000
15060000
15070000
15080000
X15090000
15100000
15110000
15120000
X15130000
15140000
15150000
15160000
15170000
15180000
X15190000
15200000
258
Registry of Motor Vehicles – UMS Programmer’s Manual
* REGISTRATION INQUIRY BY VIN NUMBER
PCTEH URI6,PGM=(UHR1064P,UHR1067P),RMV=RI,DUPKEY=UR03,
SERVICE=1
* REGISTRATION INQUIRY BY LIC NUMBER
PCTEH URI7,PGM=(UHR1065P,UHR1067P),RMV=RI,DUPKEY=LI04,
SERVICE=1
* REGISTRATION INQUIRY BY TITLE NUMBER
PCTEH URI8,PGM=(UHR1066P,UHR1067P),RMV=RI,SERVICE=1
* REGISTRATION INQUIRY BY SURROGATE NUMBER (NEW)
PCTEH URI9,PGM=(UHR1067P),RMV=RI,SERVICE=1
* REGISTRATION SCROLL
PCTEH UR02,PGM=UHRI100P,RMV=RS,SERVICE=1
* REGISTRATION SCROLL
PCTEH UR03,PGM=UHRI101P,RMV=RS,SERVICE=1
* REGISTRATION SCROLL
PCTEH UR04,PGM=UHRI102P,RMV=RS,SERVICE=1
* REGISTRATION SCROLL (NEW)
PCTEH UR05,PGM=UHR1243P,RMV=RS,SERVICE=1
* REGISTRATION/VIN OWNER NAME SCROLL
PCTEH UR07,PGM=UHR1093P,RMV=RS,SERVICE=1
***** CHANGE FOR EDS 11/17/92
* URVN - NADA INQUIRY (INQ BY VIN)
*
PCTEH UR08,PGM=(UHR1143P),RMV=URVN
* URVN - NADA INQUIRY (INQ BY VIN)
PCTEH UR08,PGM=(UHR1143P),RMV=RVN
***** END CHANGE FOR EDS 11/17/92
* RNF - CORPORATION SCROLL BY FID
PCTEH UR09,PGM=(UHR1233P),RMV=RNF
* RVN
PCTEH UR10,PGM=(UHR2143P),RMV=RVN
*
* NMP - NMVTIS PROBLEM RESOLUTION
*
PCTEH UR11,PGM=(UHR1343P),RMV=NMP
*
* NMD - NMVTIS DUPLICATE VIN RESOLUTION
*
PCTEH UR12,PGM=(UHR1353P),RMV=NMD
* POLICY HISTORY INQUIRY BY LIC NUMBER
PCTEH UU02,PGM=(UHUI110P),RMV=PH,DUPKEY=LI04,SERVICE=2
* TPIC
PCTEH UU14,PGM=UHU3023P,RMV=PIC,SERVICE=3
* TPIC BY SURROGATE
PCTEH UU15,PGM=UHU3024P,RMV=PIC,SERVICE=3
* POLICY INQUIRY BY LIC NUMBER
PCTEH UU16,PGM=(UHU2043P),RMV=PH,DUPKEY=LI04,SERVICE=7
* POLICY INQUIRY BY OOS NUMBER
PCTEH UU17,PGM=(UHU2043P),RMV=PH,DUPKEY=LD08,SERVICE=7
* UPOI
POLICY OPERATOR INQUIRY
PCTEH UU18,PGM=(UHU2013P,UHU2014P),RMV=POI,SERVICE=7
* POLICY HISTORY INQUIRY BY POLICY NUMBER
PCTEH UU19,PGM=(UHU1133P),RMV=PTH
* UPIC
PCTEH UU20,PGM=UHU4023P,RMV=PIC,SERVICE=3
* UPIC BY SURROGATE
PCTEH UU21,PGM=UHU4024P,RMV=PIC,SERVICE=3
Appendix C – Host Process Control Table
15210000
X15220000
15230000
15240000
X15250000
15260000
15270000
15280000
15290000
15300000
15310000
15320000
15330000
15340000
15350000
15360000
15370000
15380000
15390000
15400000
15410000
15420000
15430000
15440000
15450000
15460000
15470000
15480000
15490000
15500000
15510000
15520000
15530000
15540000
15550000
15560000
15570000
15580000
15590000
15600000
15610000
15620000
15630000
15640000
15650000
15660000
15670000
15680000
15690000
15700000
15710000
15720000
15730000
15740000
15750000
15760000
15770000
259
Registry of Motor Vehicles – UMS Programmer’s Manual
* POLICY INQUIRY BY LIC NUMBER
PCTEH UU22,PGM=(UHU3043P),RMV=PH,DUPKEY=LI04,SERVICE=29
* POLICY INQUIRY BY OOS NUMBER
PCTEH UU23,PGM=(UHU3043P),RMV=PH,DUPKEY=LD08,SERVICE=29
* POLICY INQUIRY BY FID
PCTEH UU24,PGM=(UHU3043P),RMV=PH,DUPKEY=UR09,SERVICE=29
* UPOI
POLICY OPERATOR INQUIRY
PCTEH UU25,PGM=(UHU3013P,UHU3014P),RMV=POI,SERVICE=29
* POLICY HISTORY INQUIRY BY POLICY NUMBER
PCTEH UU26,PGM=(UHU2133P),RMV=PTH
* VEHICLE POLICY HISTORY INQUIRY (BY REG NUMBER)
*
PCTEH VH04,PGM=(UHU2113P),RMV=UVH,DUPKEY=UR02
PCTEH VH04,PGM=(UHU2113P),RMV=UVH,DUPKEY=UR05
* VEHICLE POLICY HISTORY INQUIRY (BY VIN)
PCTEH VH05,PGM=(UHU2113P),RMV=UVH,DUPKEY=UR03
* VEHICLE POLICY HISTORY INQUIRY (BY REF)
PCTEH VH06,PGM=(UHU2113P),RMV=UVH
* VEHICLE POLICY HISTORY INQUIRY (BY REG NUMBER)
PCTEH VH07,PGM=(UHU3113P),RMV=UVH,DUPKEY=UR05
* VEHICLE POLICY HISTORY INQUIRY (BY VIN)
PCTEH VH08,PGM=(UHU3113P),RMV=UVH,DUPKEY=UR03
* VEHICLE POLICY HISTORY INQUIRY (BY REF)
PCTEH VH09,PGM=(UHU3113P),RMV=UVH
* RETRIEVE RAD VSAM DATA
PCTEH VR56,PGM=(UHR0560P),RMV=LI,SERVICE=32
* UPDATE RAD VSAM FILE
PCTEH VR57,PGM=(UHR0570P),RMV=LI,SERVICE=32
* WRITE TDQ TO START THE GENERIC OUTBOUND MESSAGE PROCESSOR
PCTEH VR58,PGM=(UHR0580P),RMV=LI
* VEHICLE TITLE INQUIRY - OLD
PCTEH VT01,PGM=(UHR1263P),RMV=VT,DUPKEY=UR03
* VEHICLE TITLE INQUIRY - NEW
PCTEH VT02,PGM=(UHR2263P),RMV=VT,DUPKEY=UR03
* VEHICLE TITLE INQUIRY - NEW + 1
PCTEH VT03,PGM=(UHR3263P),RMV=VT,DUPKEY=UR03
*
PD0890 END
* TEST HOST BASED IMAGE RETREIVAL........
PCTEH XXXX,PGM=(UHL1010P,UHL1000P),RMV=LZI1,SERVICE=13,
FLAGS=C300000000000000
LAST
DC
XL4'FFFFFFFF'
ORG
NUMENT
DC
A((LAST-FIRST)/(SYM2-SYM1))
ORG
DC
CL8'&SYSDATE',CL1' ',CL5'&SYSTIME'
END
Appendix C – Host Process Control Table
15780000
15790000
15800000
15810000
15820000
15830000
15840000
15850000
15860000
15870000
15910000
15920000
15930000
15970000
15980000
15990000
16000000
16010000
16020001
16030000
16040000
16050000
16060000
16070000
16080000
16090000
16100000
16110000
16120000
16130000
16140000
16150000
16160000
16170000
16180000
16190000
16200000
X16210000
16220000
16230000
16240000
16250000
16260000
16270000
16280000
260
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix D:
CICS Miscellaneous
CICS Abend Codes List
The following is a list of the CICS abends issued by the UMS Guest programs and a brief
statement of the reason why each was issued.
UG24
UGZ0024P
Invalid Function Code given
UGCA
UGZ0005P
Guest common area length error
UGZ0006P
Guest common area length error
UGZ0007P
Guest common area length error
UGZ0008P
Guest common area length error
UGZ0009P
Guest common area length error
UGZ0011P
Guest common area length error
UGZ0013P
Guest common area length error
UGZ0022P
Guest common area length error
UGZ0023P
Guest common area length error
UGZ0024P
Guest common area length error
UGZ0025P
Guest common area length error
UGZ0026P
Guest common area length error
Appendix D – CICS Miscellaneous
261
Registry of Motor Vehicles – UMS Programmer’s Manual
UGTH
UGZ0006P
Bad transfer of Table from Host
Transaction UG04 has failed with abend UGTH
*See note.
UGZ0024P
Read Queue Error or Load Failed for
UGZ0017p or UGZ0018p
UGTL
UGZ0001P
UGTL Txn. not run (to completion)
UMFE
UGZ0001P
Program-ID error
UGZ0005P
Error in High Core Table search
UGZ0013P
Program-ID error
UMFL
UGZ0013P
XFER
UGZ0001P
Start issued from external application
with Data, data unrecoverable.
CICS Queue Names
Queue names are usually of the form <qpfx><EIBTRMID> to show the queue function
and provide uniqueness.
<qpfx>
Program
LIC$
UGZ0005P
UMSQ
UGZ0008P
UMSR
UGZ0001P
Reference List data
UGZ0007P
UGZ0022P
UMSQ
UGZ0008P
Appendix D – CICS Miscellaneous
262
Registry of Motor Vehicles – UMS Programmer’s Manual
A few queues have ‘complete’ names as follows:
CMSL
UGZ0011P
Log for LU6.2 messages
(default name)
MRMXDTBL
UGZ0026P
UMSGCORT
UGZ0024P
UGZ0026P
Court Table data
UMSGVTAB
UGZ0024P
UGZ0026P
Violation Table data
*Note: Abend UGTH with transaction UG04 is corrected by running the following utility
transactions in succession:
UGCL (message back to the screen will read)
SYSTEM HAS BEEN RESET AND UGTL CAN BE RUN
UGTL (message back to the screen will read)
UGZ0020P, TABLE LOAD INITIATED
UGZ0020P, MAX=######## REMAINING=########
UGZ0020P, LOAD COMPLETE
Appendix D – CICS Miscellaneous
(where # = varying numbers)
263
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix D – CICS Miscellaneous
264
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix E:
UMS System Programs
Guest-Side Programs
UGZ0001P
UGZ0002P
UGZ0003P
UGZ0004P
UGZ0005P
UGZ0006P
UGZ0007P
UGZ0008P
UGZ0009P
UGZ0010P
UGZ0011P
UGZ0012P
UGZ0013P
UGZ0014P
UGZ0015P
UGZ0016P
UGZ0017P
UGZ0018P
UGZ0019P
UGZ0020P
UGZ0022P
UGZ0023P
UGZ0024P
UGZ0025P
UGZ0026P
UGZ0028P
UGZ0029P
UGZ0030P
UGZ0032P
UGZ0034P
UGZ0034Z
UGZ0035P
UGZ0036P
UGZ0037P
UGZ0038P
UGZ0039P
UGZ0040P
UGZ0060P
GUEST CONTROL/DISPATCH PROGRAM
GUEST PROCESS CONTROL TABLE
GUEST UTILITY ROUTINES, RESIDENT
ERROR MESSAGE DICTIONARY
GUEST TAIL-END CLEAN UP PROGRAM/SCREEN SEND
OPTIONAL MAP/DEMAP MODULE
GUEST INTERNAL FUNCTION DISPATCHER
GUEST HOTKEY(2ND SESSION) CONTROLLER
GUEST EXTERNAL FUNCTION SWITCHER
GUEST MENU PROGRAM
GUEST LU6.2 PROTOCOL PROGRAM
GUEST-SIDE FUDGE FOR ALAR-INIT INTERNAL DISPATCH
GUEST HOST=GUEST PROTOCOL MODULE
GUEST SITE DEFINITION MODULE
GUEST SIDE SYSTEM STARTUP PROGRAM
PROGRAM TO INITIALIZE VSAM SWAP FILE
RESIDENT DYNAMIC TABLE MODULE
GUEST STATIC TABLE MODULE (towns, states, insurance
companies and their locations)
GUEST STATIC SUBURB TABLE
GUEST TABLE TRANSMISSION CONTROL MODULE
GUEST REFERENCE LIST MANAGER
GUEST TRACE MODULE
GUEST SIDE NON-RESIDENT SERVICES
GUEST SWITCH TO ALAR
GUEST INITIALIZE ALAR BRIDGE
GUSET-SIDE REPORT QUEUING INTERFACE PROGRAM
UMS GUEST PRINTER-TABLE DEFINITIONS
GUEST-SIDE PRINT TASK
DISPLAY MODULE/FUNCTION VERSION
UMS MODULE/FUNCTION STATUS SCREEN
PRINTER OVER-RIDE TABLE
SCREEN PRINT EDIT TABLE
GUEST-SIDE SCREEN PRINT TASK (UGSP)
GUEST-SIDE SCREEN PRINT DIRECTOR
2ND LEVEL HOST CALL ROUTINE
CICS BR14 FOR 2ND LEVEL HOST CALL ROUTIND
GUEST-SIDE LXTABLE POPUP CONTROL
GUEST-SIDE HOSTIO CONTROL MODULE
Appendix E – UMS System Programs
265
Registry of Motor Vehicles – UMS Programmer’s Manual
UGZ1001P
UGZ1002P
UGZ9000P
VIRTUAL GUEST TRIGGER FOR MESSAGING APPLICATIONS
UMS VIRTUAL GUEST PROCESS-CONTROL TABLE
PROGRAM TO UNLOAD ERROR DICTIONARY FOR PC
HOST-SIDE PROGRAMS
UHZ0001P
UHZ0002P
UHZ0003P
UHZ0004P
UHZ0005P
UHZ0006P
UHZ0007P
UHZ0008P
UHZ0009P
UHZ0010P
UHZ0011P
UHZ0012P
UHZ0013P
UHZ0015P
UHZ0018P
UHZ0019P
UHZ0020P
UHZ0021P
UHZ0022P
UHZ0025P
UHZ0026P
UHZ0027P
UHZ0028P
UHZ0029P
UHZ0033P
UHZ0060P
UHZ0061P
UHZ0101P
UHZ0102P
UHZ0102S
UHZ0103P
UHZ0103S
UHZ0104P
UHZ0105P
UHZ0107P
UHZ0108P
UHZ1013P
HOST-SIDE FUNCTION DISPATCHER
HOST PROCESS CONTROL TABLE
HOST UTILITIES PROGRAM
HOST TABLE TRANSMISSION MODULE
HOST TOWN-CODE TABLE
HOST PLATE-EDITOR TABLE, OLD FORM
HOST MISC. VARIABLES MODULE (CODE/TEXT)
HOST SECURITY INITIALIZATION PROGRAM
HOST USER DATA STASH ROUTINE
HOST PLATE-EDITOR TABLE ONLY FOR SECTION 5 PLATES
HOST LU6.2 PROTOCOL MODULE
HOST PLATE – EDITOR TABLE ONLY FOR GENERIC PLATES, NEW FORM
HOST HOST=GUEST PROTOCOL MODULE
HOST INITIALIZATION PROGRAM (UGTL/UHTL)
HOST PASSWORD CHANGE CONTROL
HOST-SIDE INTERFACE TO LXTABLE (UGZ0006P)
HOST MESSAGE OUTPUT MODULE
HOST-SIDE MONITOR PROGRAM
HOST-SIDE ALAR CALLED LOOKASIDE PURGE
HOSTSIDE LU6.2 PROTOCALL MODULE FOR THROTTLE REGION
LU6.2 THROTTLE MANAGEMENT TABLE
CJIS DATA TRACE ENABLE/DISABLE
HOST-SIDE CROSS-GEGION THROTTLE MODE MODULE
HOST-SIDE TERMINAL NMBER RETURN FOR BATCH #
HOST-SIDE LU6.2 LONG DATA FORM PROTOCALL MODULE
HOST-SIDE HOSTIO MANAGER
HOSTIO TABLE DEFINITIONS
SECUREITY RECORD MANAGEMENT
VTAB TABLE LOAD ROUTINE
STATIC VTAB LOAD SUBROUTINE
CORT TABLE LOAD ROUTINE
STATIC CORT LOAD SUBROUTINE
TOWN TABLE LOAD ROUTINE
PASSWORD CHANGER
RETURN TERMINAL FOR CLERK-ID
BUILD TERMID MAP FOR CONVERSIONG
VIRUTAL GUEST HOST CALLER
Appendix E – UMS System Programs
266
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix F:
Guest Common Area
COBOL Example
* UNINSURED MOTORIST. COMMON-AREA, GUEST SIDE.
* USE AS-IS FOR VS-COBOL. COPY REPLACING INDEX BY POINTER
* FOR COBOL2
05 UGCOMMON-SYSTEM-PROTOCALL-DATA
PIC X(64).
05 FILLER REDEFINES UGCOMMON-SYSTEM-PROTOCALL-DATA.
10 UGCOMMON-DOUBLE-WORD-TEMP.
15 UGCOMMON-DOUBLE-WORD1
PIC S9(09) COMP.
15 FILLER REDEFINES UGCOMMON-DOUBLE-WORD1.
20 UGCOMMON-DOUBLE-WORD1-PNTR USAGE INDEX.
15 UGCOMMON-DOUBLE-WORD2
PIC S9(09) COMP.
15 FILLER REDEFINES UGCOMMON-DOUBLE-WORD2.
20 UGCOMMON-DOUBLE-WORD2-PNTR USAGE INDEX.
10 UGCOMMON-XCTL-LENGTH
PIC S9(04) COMP.
10 UGCOMMON-RESPONSE-LENGTH
PIC S9(04) COMP.
10 UGCOMMON-CURRENT-FUNCTION
PIC X(04).
10 UGCOMMON-ALLON-FLAGS
PIC X.
10 UGCOMMON-ALLON-FLAGS-2
PIC X.
10 UGCOMMON-PREVIOUS-FUNCTION
PIC X(04).
10 UGCOMMON-RECEIVED-MAP-LENGTH
PIC S9(04) COMP.
10 UGCOMMON-CUR-FUNC-CTRL-FLAGS.
15 UGCOMMON-PROCESS-BYTE-1
PIC X.
15 UGCOMMON-PROCESS-BYTE-2
PIC X.
15 UGCOMMON-PROCESS-BYTE-3
PIC X.
15 UGCOMMON-PROCESS-BYTE-4
PIC X.
15 UGCOMMON-USER-FLAGS.
20 UGCOMMON-F4-STRING
PIC X(04).
20 UGCOMMON-F9-STRING
PIC X(04).
10 UGCOMMON-PREV-MAP-NAME
PIC X(07).
10 UGCOMMON-MESSAGE-TEXT
PIC X(01).
88 UGCOMMON-LAST-MAP-HAD-TEXT VALUE 'Y'.
10 UGCOMMON-REQUESTED-TRANID
PIC X(04).
10 UGCOMMON-GENERAL-STATUS-FLAG
PIC X.
10 FILLER
PIC X(15).
05 UGCOMMON-MODULE-NAME-AREA
PIC X(192).
05 FILLER REDEFINES UGCOMMON-MODULE-NAME-AREA.
10 UGCOMMON-PROTOCALL-PROCESSOR
PIC X(08).
10 UGCOMMON-APPLICATION-MODULE-1 PIC X(08).
10 UGCOMMON-APPLICATION-MODULE-2 PIC X(08).
10 UGCOMMON-APPLICATION-MODULE-3 PIC X(08).
Appendix F – Guest Common Area
267
Registry of Motor Vehicles – UMS Programmer’s Manual
10 UGCOMMON-CLEANUP-PROCESSOR
PIC X(08).
10 UGCOMMON-RETURN-AFTER-HOST
PIC X(08).
10 UGCOMMON-MAP-TRANSLATION-TBL
PIC X(08).
10 UGCOMMON-SCREEN-SENDBACK-MOD
PIC X(08).
10 UGCOMMON-INTERNAL-DISPATCH-MOD PIC X(08).
10 UGCOMMON-INTERNAL-REFERENC-MOD PIC X(08).
10 UGCOMMON-NONRES-SERVICES-MOD
PIC X(08).
10 UGCOMMON-LXTABLE-PROCESSOR
PIC X(08).
10 UGCOMMON-REPORT-PRINT-PROC
PIC X(08).
10 UGCOMMON-LEVEL2-HOST-CALL
PIC X(08).
10 UGCOMMON-CICS-BR14-EQUIV
PIC X(08).
10 UGCOMMON-HOST-IO-HANDLER
PIC X(08).
10 UGCOMMON-PRINTER-INTERFACE
PIC X(08).
10 FILLER
PIC X(56).
05 UGCOMMON-ASSIST-ADDRESS-AREA
PIC X(192).
05 FILLER REDEFINES UGCOMMON-ASSIST-ADDRESS-AREA.
10 UGCOMMON-DATE-ROUTINE-ADDRESS PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-DATE-ROUTINE-ADDRESS.
15 UGCOMMON-DATE-ROUTINE-PNTR USAGE INDEX.
10 UGCOMMON-DATA-NAME-ADDRESS
PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-DATA-NAME-ADDRESS.
15 UGCOMMON-DATA-NAME-PNTR USAGE INDEX.
10 UGCOMMON-FROM-HOST-TEXT-ADDR
PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-FROM-HOST-TEXT-ADDR.
15 UGCOMMON-FROM-HOST-TEXT-PNTR USAGE INDEX.
10 UGCOMMON-TO-HOST-TEXT-ADDRESS PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-TO-HOST-TEXT-ADDRESS.
15 UGCOMMON-TO-HOST-TEXT-PNTR USAGE INDEX.
10 UGCOMMON-GUEST-CONTROL-TABLE
PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-GUEST-CONTROL-TABLE.
15 UGCOMMON-GUEST-CONTROL-PNTR USAGE INDEX.
10 UGCOMMON-MISC-TRANSLATE-TABLES PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-MISC-TRANSLATE-TABLES.
15 UGCOMMON-MISC-TRANSLATE-PNTR USAGE INDEX.
10 UGCOMMON-GENERAL-EDIT-SERVICES PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-GENERAL-EDIT-SERVICES.
15 UGCOMMON-GENERAL-EDIT-PNTR USAGE INDEX.
10 UGCOMMON-SCHELL-SORT-ADDRESS
PIC S9(08) COMP.
10 FILLER REDEFINES UGCOMMON-SCHELL-SORT-ADDRESS.
15 UGCOMMON-SCHELL-SORT-PNTR USAGE INDEX.
10 FILLER
PIC X(160).
05 UGCOMMON-SECURITY-SAVE-DATA
PIC X(24).
05 FILLER REDEFINES UGCOMMON-SECURITY-SAVE-DATA.
10 UGCOMMON-SITE-NAME
PIC X(04).
10 UGCOMMON-USER-ID
PIC X(04).
10 UGCOMMON-PASSWORD
PIC X(04).
10 UGCOMMON-TERMINAL-NAME
PIC X(04).
10 FILLER
PIC X(08).
05 UGCOMMON-SCROLL-BASE-DATA
PIC X(742).
05 FILLER REDEFINES UGCOMMON-SCROLL-BASE-DATA.
10 UGCOMMON-LAST-SCROLL-FUNC
PIC X(04).
10 FILLER
PIC X(02).
10 UGCOMMON-SCROLL-FORMAT
PIC X(12).
10 FILLER REDEFINES UGCOMMON-SCROLL-FORMAT.
15 UGCOMMON-SCROLL-ENT-PER-LINE PIC 9.
15 UGCOMMON-SCROLL-SURR-PER-ENT PIC 9.
Appendix F – Guest Common Area
268
Registry of Motor Vehicles – UMS Programmer’s Manual
15 UGCOMMON-SCROLL-DATA-LINE1 PIC S9(4) COMP.
15 UGCOMMON-SCROLL-SURR-TYPE-TBL PIC X(08).
*
NONE VALUE LOW-VALUES OR SPACES.
*
VEHR VALUE '0'.
*
VEHC VALUE '1'.
*
VEHT VALUE '2'.
*
VMOD VALUE '3'.
*
PERS VALUE '4'.
*
NOWN VALUE '5'.
*
PLCY VALUE '6'.
*
OACD VALUE '7'.
*
OVIO VALUE '8'.
*
OWTH VALUE '9'.
*
CITA/IVIO VALUE 'A'.
*
ACTN VALUE 'C'.
*
DECI VALUE 'D'.
*
PINQ VALUE 'E'.
*
AUTI VALUE 'F'.
*
SUBM VALUE 'G'.
*
SDIP XCLU VALUE 'H'.
*
REIN EXPA VALUE 'M'.
*
MSCO VALUE 'V'.
*
DISP VALUE 'W'.
10 UGCOMMON-SCROLL-KEY
PIC X(67).
10 UGCOMMON-CORE-STATUS-FLAG
PIC X(01).
10 UGCOMMON-PAGE-AREA
PIC X(96).
10 UGCOMMON-PAGE-TABLE REDEFINES UGCOMMON-PAGE-AREA
OCCURS 12 TIMES PIC X(08).
10 FILLER REDEFINES UGCOMMON-PAGE-AREA.
15 UGCOMMON-TOP-1
PIC X(08).
15 UGCOMMON-BOTTOM-11
PIC X(88).
10 FILLER REDEFINES UGCOMMON-PAGE-AREA.
15 UGCOMMON-TOP-11
PIC X(88).
15 UGCOMMON-BOTTOM-1
PIC X(08).
10 UGCOMMON-SCROLL-TABLE
PIC X(560).
10 FILLER REDEFINES UGCOMMON-SCROLL-TABLE.
15 UGCOMMON-SURR-NUMB OCCURS 140 TIMES
INDEXED BY UGC-SURR-PNTR
PIC S9(09) COMP.
05 UGCOMMON-APPLICATION-WORK-AREA
PIC X(512).
05 FILLER REDEFINES UGCOMMON-APPLICATION-WORK-AREA.
10 UGCOMMON-STANDARD-PARM-AREA
PIC X(22).
10 FILLER REDEFINES UGCOMMON-STANDARD-PARM-AREA.
15 UGCOMMON-TEXT-MOVE-FLAG-1
PIC X.
88 UGCOMMON-LEN-IS-ADDRESS-MODE
VALUE 'A'.
88 UGCOMMON-LEN-IS-FULL-WORD VALUE 'L'.
15 UGCOMMON-OCCUR-INCRIMENT-FLAG PIC X.
88 UGCOMMON-INCRIMENT-OCCUR VALUE 'Y'.
88 UGCOMMON-DONT-INCRIMENT-OCCUR
VALUE 'N'.
15 UGCOMMON-DATE-AREA.
20 UGCOMMON-DATE-INPUT-FORMAT PIC X.
* 0 = BINARY (DO NOT RETURN DAY OF WEEK)
* 1 = GREGORIAN (DO NOT RETURN DAY OF WEEK)
* 2 = JULIAN (DO NOT RETURN DAY OF WEEK)
Appendix F – Guest Common Area
269
Registry of Motor Vehicles – UMS Programmer’s Manual
* 4 = BINARY (RETURN DAY OF WEEK)
* 5 = GREGORIAN (RETURN DAY OF WEEK)
* 6 = JULIAN (RETURN DAY OF WEEK)
20 UGCOMMON-DATE-RETURN-STATUS PIC X.
* 0 = OK
* 1 = RANGE ERROR
* 2 = NON-NUMERIC INPUT
* 3 = INVALID MONTH
* 4 = INVALID DAY OF MONTH
* 5 = INVALID YEAR
* 6 = INVALID DAY OF YEAR
* 7 = NULL DATE INPUT
* 8 = FORMAT UNKNOWN
20 UGCOMMON-DATE-BINARY-FORMAT.
25 UGCOMMON-DATE-BINARY-FORMAT-N4
PIC S9(04) COMP.
20 UGCOMMON-DATE-JULIAN-FORMAT PIC 9(07).
20 FILLER REDEFINES UGCOMMON-DATE-JULIAN-FORMAT.
25 UGCOMMON-DATE-JULIAN-YEAR PIC 9(04).
25 UGCOMMON-DATE-JULIAN-DAY PIC 9(03).
20 UGCOMMON-DATE-GREG-FORMAT-X.
25 UGCOMMON-DATE-GREG-FORMAT PIC 9(08).
20 FILLER REDEFINES UGCOMMON-DATE-GREG-FORMAT-X.
25 UGCOMMON-DATE-GREG-YEAR PIC 9(04).
25 UGCOMMON-DATE-GREG-MONTH PIC 9(02).
25 UGCOMMON-DATE-GREG-DAY
PIC 9(02).
20 UGCOMMON-DATE-DAY-OF-WEEK PIC 9.
10 UGCOMMON-INVOCATION-ENTRY-INFO PIC X(16).
10 FILLER REDEFINES UGCOMMON-INVOCATION-ENTRY-INFO.
15 UGCOMMON-SCREEN-NAME
PIC X(07).
15 UGCOMMON-ENTRY-REASON
PIC S9(04) COMP.
88 UGCOMMON-ENTRY-FIRST-TIME VALUE +00.
88 UGCOMMON-ENTRY-ENTER
VALUE +01.
88 UGCOMMON-ENTRY-F7
VALUE +02.
88 UGCOMMON-ENTRY-F8
VALUE +03.
88 UGCOMMON-ENTRY-F4
VALUE +04.
88 UGCOMMON-ENTRY-RESCROLL VALUE +05.
88 UGCOMMON-ENTRY-FROM-HOST VALUE +06.
88 UGCOMMON-ENTRY-AFTER-F9 VALUE +07.
88 UGCOMMON-ENTRY-AFTER-F12 VALUE +08.
88 UGCOMMON-ENTRY-AFTER-FUNC VALUE +09.
88 UGCOMMON-ENTRY-AFTER-DUPKEY VALUE +10.
88 UGCOMMON-ENTRY-F9-NOSELECT VALUE +11.
88 UGCOMMON-ENTRY-F5
VALUE +12.
15 UGCOMMON-F4-SURROGATE-TYPE PIC X(01).
88 UGCOMMON-F4-VEHR-TYP-0 VALUE '0'.
88 UGCOMMON-F4-VEHC-TYP-1 VALUE '1'.
88 UGCOMMON-F4-VEHT-TYP-2 VALUE '2'.
88 UGCOMMON-F4-VMOD-TYP-3 VALUE '3'.
88 UGCOMMON-F4-PERS-TYP-4 VALUE '4'.
88 UGCOMMON-F4-NONW-TYP-5 VALUE '5'.
88 UGCOMMON-F4-PLCY-TYP-6 VALUE '6'.
15 UGCOMMON-F4-SURROGATE
PIC S9(09) COMP.
15 UGCOMMON-CURRENT-BINARY-DATE.
20 UGCOMMON-CURRENT-BINARY-DATE9 PIC S9(04) COMP.
10 UGCOMMON-RESERVED-SURROGATES.
Appendix F – Guest Common Area
270
Registry of Motor Vehicles – UMS Programmer’s Manual
15 UGCOMMON-RESERVED-SURR-LIST OCCURS 12 TIMES
INDEXED BY UGCOMMON-RESERVED-SURR-INDX.
20 UGCOMMON-RESERVED-SURR-TYPE PIC X.
20 UGCOMMON-RESERVED-SURR-VALUE PIC S9(9) COMP.
10 UGCOMMON-CURRENT-MAP-LENGTH
PIC S9(09) COMP.
10 UGCOMMON-INPUT-MAP-ADDRESS
PIC S9(09) COMP.
10 FILLER REDEFINES UGCOMMON-INPUT-MAP-ADDRESS.
15 UGCOMMON-INPUT-MAP-PNTR USAGE INDEX.
10 UGCOMMON-OUTPUT-MAP-ADDRESS
PIC S9(09) COMP.
10 FILLER REDEFINES UGCOMMON-OUTPUT-MAP-ADDRESS.
15 UGCOMMON-OUTPUT-MAP-PNTR USAGE INDEX.
10 UGCOMMON-HOST-DATA-AREA-ADDR
PIC S9(09) COMP.
10 FILLER REDEFINES UGCOMMON-HOST-DATA-AREA-ADDR.
15 UGCOMMON-HOST-DATA-AREA-PNTR USAGE INDEX.
10 UGCOMMON-GETMAIN-RESERVED
PIC X(16).
* DEFINED THE LAYOUT OF THE GETMAIN RESERVED AREA
10 FILLER REDEFINES UGCOMMON-GETMAIN-RESERVED.
* CONTAINS GETMAINED AREA FOR RECORDS FOR VIRTUAL GUEST
* WHEN VIRTUAL GUEST IS RUNNING.
15 UGCOMMON-VG-LONG-BLOCK-ADDR USAGE INDEX.
15 FILLER
PIC X(12).
10 UGCOMMON-INTERFACE-ERR-FLAG
PIC X.
* SET THIS TO A "Y" IF YOU DO NOT WANT THE ERROR TO COME BACK TO
* YOUR PROGRAM. ERROR MESSAGES LESS THAN 200000000 NEVER RETURN.
10 UGCOMMON-INTERNAL-DISPTCH-AREA.
15 UGCOMMON-INTERNAL-DISPTCH-TYPE PIC X(01).
88 UGCOMMON-GUEST-APPL-REQUEST VALUE '0'.
88 UGCOMMON-HOST-DUPKEY-REQUEST VALUE '1'.
88 UGCOMMON-VGUEST-APPL-REQUEST VALUE '2'.
88 UGCOMMON-VHOST-DUPKEY-REQUEST VALUE '3'.
15 UGCOMMON-INTERNAL-DISPTCH-NAME PIC X(04).
15 UGCOMMON-INTERNAL-DISPTCH-SAVE PIC X(24).
10 UGCOMMON-EDIT-CONTROL-AREA.
15 UGCOMMON-EDIT-FUNCTION
PIC S9(4) COMP.
15 UGCOMMON-EDIT-LENGTH
PIC S9(4) COMP.
15 UGCOMMON-3BYTE-DATE
PIC X(03).
10 FILLER
PIC X(345).
05 UGCOMMON-ERROR-DATA.
10 UGCOMMON-CURRENT-ERROR-CODE SYNC PIC S9(09) COMP.
10 UGCOMMON-ERROR-TEXT.
15 FILLER
PIC X(50).
10 UGCOMMON-3270-CURSOR-POSITION PIC S9(04) COMP.
05 UGCOMMON-PROGRAM-COMMAREA
PIC X(2290).
Appendix F – Guest Common Area
271
Registry of Motor Vehicles – UMS Programmer’s Manual
ASSEMBLER Example
* UNINSURED MOTORIST. COMMON-AREA, GUEST SIDE.
UGCOMMON DSECT
UGCPROTO DS XL64
SYSTEM PROTOCALL DATA
ORG UGCPROTO
* WITH TWO EXCEPTIONS, THE PROTOCALL AREA IS RESERVED FOR THE CONTROL
* SOFTWARE. APPLICATIONS MAY USE THE DOUBLE-WORD TEMP AND SHOULD NOTE
* THE QUALIFICATION ABOUT PREVIOUS MAP-NAME
UGCDTEMP DS D
GENERAL PURPOSE DOUBLE-WORD TEMPORARY
UGCCLENG DS H
LENGTH FOR USE WITH XCTL.
UGCRDLEN DS H
INQUIRY/REPLY DETAIL LENGTH
UGCCURFN DS CL4
CURRENT FUNCTION-NAME
UGCALLON DS XL1
FLAG BYTE WITH ALL BITS INITIALLY ON
UGCMAPFI EQU B'00000001' MAP/DEMAP OPERATION IS DEMAP
UGCMAPFO EQU B'00000010' MAP/DEMAP OPERATION IS MAP
UGCMAPEF EQU B'10000000' ERROR FLAGGING REQUESTED FOR TZA
UGCFLAG2 DS CL1
ADDITIONAL FLAG BYTE SC1192
UGCF2_SSEND1 EQU B'00000001' SET BY 1P ON TERMINATING 2NDRY 92
UGCF2_SSEND2 EQU B'00000010' SET BY 1P ON READMAP IF END1 SC1192
* BOTH ABOVE BITS CLEARED IF SSEND2 ON AT MAP READ
SC1192
UGCF2_OVRIDE EQU B'00000100' SET BY 6P FOR OVERRIDE SECURITYSC1193
* CLEARED BY 1P ON FUNCTION CHANGE
SC1193
UGCF2_PEZL01 EQU B'00001000' SET BY ZL01 TO REQUEST F9
SC0694
* PERCOLATION. CLEARED BY ZL01 AFTER PERCOLATION
SC0694
UGCF2_FUNLOK EQU B'00010000' SET IF FUNCTION IS LOCKED
SC0994
* CLEARED BY FUNCTION ON DETECTING REASON FOR UNLOCK
SC0994
UGCPREFN DS CL4
PREVIOUS FUNCTION-NAME
UGCRCVML DS AL2
MAP-LENGTH FROM RECEIVE-MAP
UGCCURFL DS CL12
CURRENT FUNCTION CONTROL-FLAGS
UGCPFLG1 EQU UGCCURFL+0,1 PROCESS FLAG BYTE-1
UGCPFLG2 EQU UGCCURFL+1,1 PROCESS FLAG BYTE-2
UGCPFLG3 EQU UGCCURFL+2,1 PROCESS FLAG BYTE-3
UGCPFLG4 EQU UGCCURFL+3,1 PROCESS FLAG BYTE-4
UGCPFLGU EQU UGCCURFL+4,8 USER FLAGS IF NOT (F4+F9)
UGCPPF4S EQU UGCCURFL+4,4 F4 STRING IF (F4)
UGCPPF9S EQU UGCCURFL+8,4 F9 STRING IF (F9)
* THIS INFORMATION COMES FROM THE PROCESS-CONTROL TABLE AND INDICATES
* SUCH INFORMATION AS (1)WHAT FUNCTION KEY FUNCTIONS THE CURRENT FUNCTION
* ACCEPTS, (2)WHAT SURROGATES ARE REQUIRED FOR A F4 ENTRY, ETC.
RMVMV.RMV.UMSMACR3(UGZCOMMA) - 01.11
Columns 00001 00072
d ===>
Scroll ===> CSR
UGPREVMA DS CL7
PREVIOUSLY SHOWN MAP-NAME
* NOTE: IF THE USER-PROGRAM IS REUSING THE LAST MAP, BUT HAS DONE
* SOMTHING WHICH MAKES A DATA-ONLY SEND INAPPROPRIATE, IT SHOULD ZAP
* THE PREVIOUS MAP NAME
UGMSGTXT DS CL1
SET BY OUTPUT-PROCESSOR TO C'Y' IF THE
* LAST MAP SENT HAD TEXT IN THE MESSAGE FIELD.
UGTRANID DS CL4
REQUESTED DISPATCH TRANID
UGSTAFLG DS CL1
GENERAL STATUS-FLAG
UGSTSRQD EQU B'00000001' SIGNON IS REQUIRED
UGSTSALW EQU B'00000010' SIGNON IS ALLOWED
UGSTFRQD EQU B'00000100' FUNCTION-SELECTION IS REQUIRED
UGSTLIVE EQU B'10000000' AREA IS LIVE COMMON-AREA (DOCUMENTARY)
Appendix F – Guest Common Area
272
Registry of Motor Vehicles – UMS Programmer’s Manual
UGSTLOGT EQU B'01000000' ACTIVE TRANSACTION IS LOGON TRANSACTION
UGSTHOTK EQU B'00100000' ACTIVE TRANSACTION IS SECONDARY MODE
UGST2LIM EQU B'00010000' SECONDARY MODE IS LIMITED SESSION
UGSTREFL EQU B'00001000' REFERENCE LIST ESTABLISHMENT BIT
* NOTE: THE DIFFERENCE BETWEEN SIGNON REQUIRED AND ALLOWED OCCURS WHEN
* THE SIGNON SCREEN IS REENTERED BY A CLEAR KEY AS OPPOSED TO ENTERED
* AS A RESULT OF CICS SIGNON
*
ORG
UGCMODNA DS XL192
MODULE NAME AREA
ORG UGCMODNA
UGCOUTPR DS CL8
OUTPUT-SIDE PROTOCALL PROCESSOR
UGCMODX DS 0CL(4*8)
MODULES FROM PCTE ENTRY
UGCMOD1 DS CL8
1ST APPLICATION PROCESSOR MODULE
UGCMOD2 DS CL8
2ND APPLICATION PROCESSOR MODULE
UGCMOD3 DS CL8
3RD APPLICATION PROCESSOR MODULE
UGCCLEAN DS CL8
TAIL-END CLEANUP PROCESSOR
UGCRETRN DS CL8
MODULE FOR RETURN AFTER HOST INTERFACE
UGMAPINO DS CL8
OPTIONAL MAP TRANSLATION TABLE NAME
UGSENDBK DS CL8
NAME OF SCREEN SEND-BACK MODULE
UGDISRTN DS CL8
NAME OF INTERNAL FUNCTION DISPATCHER
UGREFRTN DS CL8
NAME OF REFERENCE-LIST MANAGEMENT RTN
UGNRSERV DS CL8
NON-RESIDENT SERVICES MODULE SC1289
UGLXTPRC DS CL8
LXTABLE PROCESSOR
SC0491
UGRPTPRT DS CL8
REPORT PRINT PROCESSOR
SC0591
UGHOSTL2 DS CL8
LEVEL 2 HOST CALL INTERFACE SC0297
UGCIBR14 DS CL8
CICS BR14 EQUIVALENT
SC0297
UGHOSTIO DS CL8
HOST IO HANDLER
SC0298
UGSPIMOD DS CL8
STD PRINT INTERFACE SC1200
ORG
UGCASSRT DS XL192
ASSIST ROUTINE/TABLE ADDRESS AREA
* EFFECTIVLY REDUCED FROM 192 BYTES (48 EPTS) TO 184 BYTES SC1193
* (46 EPTS) BY OVERRIDE/SUPERVISOR SECURITY MODIFICATIONS SC1193
ORG UGCASSRT
UGCAMOD1 DS 0XL(4*8)
LENGTH OF VECTOR IN UGZ0003P
UGCADTCR DS A
ADDRESS OF DATE CONVERSION ROUTINE
UGCADNAR DS A
ADDRESS OF DATA-NAME TO ADDRESS ROUTINE
UGCAITIR DS A
ADDRESS OF FROM-HOST TEXT FETCH ROUTINE
UGCAOTIR DS A
ADDRESS OF TO-HOST TEXT FETCH ROUTINE
UGCACTLT DS A
ADDRESS OF GUEST CONTROL-TABLE
UGCAMSTR DS A
ADDRESS OF MISC TRANSLATE TABLES
UGCEDRTN DS A
EDIT SERVICES DRIVER ADDRESS
UGCSSORT DS A
ADDRESS OF SCHELL-SORT ROUTINE SC0190
ORG
UGCPFSEC DS XL24
SECURITY-SAVE DATA
ORG UGCPFSEC-8
OVERRIDE PASSWORD AREA
SC1193
UG_OVPASSWD DS CL8
OVERRIDE PASSWORD
SC1193
ORG UGCPFSEC
UFHGSITE DS CL4
GUEST SITE NAME
UFHGUSER DS CL4
GUEST USER-ID
UFHGPSWD DS CL4
GUEST PASSWORD, PART-1
UFHGTERM DS CL4
GUEST TERMINAL-NAME
UFHGPSW2 DS CL4
GUEST PASSWORD, PART-2
UG_OVUSER DS CL4
GUEST OVERRIDE USER ID
SC1193
*
**
Appendix F – Guest Common Area
273
Registry of Motor Vehicles – UMS Programmer’s Manual
*** W A R N I N G
** FROM THE APPLICATIONS PERSPECTIVE, ALL DATA PRECEEDING THIS
* POINT IS READ-ONLY
ORG
UFGSCROL DS 742CL1
SCROLL BASE DATA
UFGSCRO$ EQU *-UFGSCROL
LENGTH OF DATA
ORG UFGSCROL
UFGSCLFN DS CL4
LAST SCROLL-FUNCTION NAME
DS CL2
UNUSED AT THIS TIME
UFGSCFMT DS 0CL12
FORMAT DATA FOR SCROLL-TABLE
UFGSCEPL DS ZL1
#ENTRIES PER LINE
UFGSCSPE DS ZL1
#SURROGATES PER ENTRY
UFGSCLN1 DS H
FIRST LINE USED ON SCREEN
UFGSCTTB DS 8CL1
SURROGATE TYPE TABLE
* '0'=VEHR, '1'=VEHC, '2'=VEHT, '3'=VMOD, '4'=PERS, '5'=NOWN
* '6'=PLCY,
* '7'=OACD, '8'=OVIO, '9'=OWTH, 'A'=CITA, 'C'=ACTN, 'D'=DECI,
* 'E'=PINQ, 'F'=AUTI, 'G'=SUBM, 'H'=SDIP XCLU,
'M'=EXPA, CP1197
* 'V'=MSCO W'=DISP
CP1197
* (25-1STLINE)*(#SURR/ENT)*(ENT/LINE) .LE. 140
UFGSKEY DS CL67
SCROLL KEY
UFGSFLAG DS CL1
CORE STATUS FLAG
UFGSPTBL DS 12CL8
PAGE TABLE
UFGSCTBL DS CL560
SCROLL/BROWSE TABLE
ORG
*NOTE: THE CONCEPT HERE IS THAT THE USER IS SUPPOSED TO BE ABLE TO DO A
* F4 SELECT FROM A SCROLL-SCREEN AND VIEW A RECORD. WHEN THE USER THEN
* DECIDES HE HAS NOT SELECTED THE CORRECT RECORD, ENTERING THE SCROLL
* COMMAND AGAIN IS SUPPOSED TO GET HIM THE SAME SCROLL SCREEN. THIS IS
* INTENDED TO BE PROVIDED AT TWO LEVELS: (1) UNCONDITIONAL ABILITY TO
* COME BACK TO THE LAST SCROLL PAGE WITH NO ABILITY TO PAGE-BACK, AND
* (2) CONDITIONAL ABILITY TO COME BACK TO THE LAST SCROLL PAGE AND PAGE
* BACK. THE CONDITIONAL ABILITY IS BASED ON IF ANOTHER APLICATION HAS
* CORRUPTED THE SCROLL BASE-DATA. BASICLY, A SCROLL APPLICATION WILL
* PUT HIGH-VALUES IN UFGSFLAG INDICATING IT HAS VALID CONTENT IN THE
* CORE-TABLES. ANY OTHER APPLICATION MAY CORRUPT THIS AREA IF IT DES* IRES, BUT MUST FIRST PUT LOW-VALUES IN UFGSFLAG. THE OTHER SCROL AREA
* ARE NOT TO BE USED EXCEPT BY SCROLL APPLICATIONS. FOR 3270 GUESTS, A
* FUNCTION KEY WILL BE DESIGNATED FOR SCROLL-REENTRY.
* THE CORRUPTABLE AREA BEGINS WITH THE SECOND ENTRY IN UFGSPTBL.
*
UGCDSWKA DS 512CL1
DATA-SERVICES/APPL WORK AREA
ORG UGCDSWKA
UGCDSTPR DS 0XL22
STANDARD PARM AREA
* THE TEXT-MOVE ROUTINE IS CALLED PASSING COMMON-AREA,SOURCE,LENGTH
* SUBJECT TO THE FOLLOWING FLAGS. THE LENGTH ARGUMENT MAYBE A FULL* WORD CONTAINING THE ACTUAL LENGTH, OR THE ADDRESS OF A BYTE FOLLO* WING THE LAST TO MOVE. THE USER SPECIFIES IF THE OCCURANCE COUNT
* IS TO BE INCRIMENTED. THE FIELDS ARE INITIALIZED TO 'AN' AND RESET
* TO THIS VALUE AFTER EACH CALL.
UGCDMVF1 DS CL1
TEXT MOVE FLAG-1
*
'A'="LENGTH" PARAMETER IS ADDRESS-MODE
*
'L'="LENGTH" PARAMETER IS FULL-WORD
UGCDMVF2 DS CL1
OCCURANCE INCRIMENT FLAG
*
'Y'=INCRIEMNT OCCURANCE COUNTER
*
'N'=DO NOT INCRIEMNT OCCURANCE COUNTER
Appendix F – Guest Common Area
274
Registry of Motor Vehicles – UMS Programmer’s Manual
UGCDCONA DS 0CL20
DATE CONVERSION AREA
UGCDCFMT DS CL1
INPUT FORMAT
UGCDCSTA DS CL1
RETURN STATUS
UGCDCBIN DS XL2
BINARY FORMAT
UGCDCJUL DS CL7
JULIAN YYYYDDD FORMAT
UGCDCGRE DS CL8
GREGORIAN YYYYMMDD FORMAT
UGCDCDAY DS CL1
DAY OF WEEK#
*
UGENTRYI DS 0CL16
INVOCATION ENTRY INFORMATION
UGSCREEN DS CL7
NAME OF SCREEN ON TERMINAL
UGERCODE DS XL2
ENTRY REASON
* 00=ENTRY FROM CONTROL-SUPERVISOR (FIRST TIME)
* 01=REENTRY FROM CONTROL-SUPERVISOR AFTER RECEIVE-MAP/ENTER
* 02=REENTRY FROM CONTROL-SUPERVISOR AFTER RECEIVE-MAP/F7
* 03=REENTRY FROM CONTROL-SUPERVISOR AFTER RECEIVE-MAP/F8
* 04=ENTRY FROM CONTROL-SUPERVISOR AFTER RECEIVE-MAP/F4
* 05=ENTRY FROM CONTROL-SUPERVISOR AFTER RECEIVE-MAP/RESCROLL
* 06=ENTRY/REENTRY FROM HOST INTERFACE
* 07=ENTRY AFTER F9 SWITCH
* 08=ENTRY AFTER F12
* 09=ENTRY AFTER INTERNAL FUNCTION DISPATCH
* 10=ENTRY AFTER HOST DUPKEY FUNCTION CHANGE
* 11=ENTRY WITH CURSOR ABOVE FIRST SCROLL-LINE ON F9
SC0492
*
AND NULL9=YES IN PCTEG ENTRY
SC0492
* 12=F5 (REPRINT)
SC1092
UGERSTYP DS CL1
SURROGATE-TYPE FOR F4
UGERSURR DS CL4
SURROGATE FOR F4
UGCDATE DS CL2
DATE, SERIAL FORMAT
DS 0F
UGSURLST DS 12XL5
RESERVED SURROGATE TYPE/VALUE LIST
UGSURTYP EQU UGSURLST+0,1 SURROGATE TYPE. S/A F4&F9 TYPES
UGSURVAL EQU UGSURTYP+1,4 SURROGATE VALUE
UGSURLEN EQU *-UGSURLST
TABLE LENGTH
*
UGCLRDTA DS 0XL32
CLEARED BY UGZ0001P ON EACH REENTRY
UGMAPLEN DS F
CURRENT OUTPUT-MAP LENGTH
UGINPMAP DS F
INPUT MAP ADDRESS
UGOUTMAP DS F
OUTPUT MAP ADDRESS
UGINTDTA DS F
HOST INTERFACE DATA AREA
UGMEMLST DS 4F
RESERVED FOR 4 MORE GETMAIN AREAS-SC0590
UGLONGHI EQU UGMEMLST+12,4,C'F' LONG HOST AREA ADDRESS
* NOTE, ABOVE AREAS DO NOT EXIST IF CELL VALUE IS ZERO
* CONVENTION WILL BE THAT IF THE APPLICATION WILL FREEMAINS UNNEEDED
* AREAS IT WILL CLEAR THE CELL. THE REQUIRED LENGTH FOR THE HOST
* INTERFACE AREA IS NEAR THE START OF THIS AREA.
UGINTEFL DS CL1
HOST INTERFACE ERROR-PROCESSING FLAG.
* APPLICATION MUST SET TO 'Y' IF INTERFACE IS TO INTERCEPT HOST DET* ECTED ERRORS AND NOT RETURN TO APPLICATION. CLEARED BY INTERFACE.
*
* DATA ORIENTED TO INTERNAL FUNCTION DISPATCH:
UGDISDTA DS 0CL29
INTERNAL DISPATCH DATA AREA
UGDISPTP DS CL1
INTERNAL DISPATCH TYPE:
*
C'0'=GUEST APPL REQUEST
*
C'1'=HOST DUPKEY REQUEST
*
C'2'=GUEST APPL REQUEST VIRTUAL GUEST
*
C'3'=HOST DUPKEY REQUEST VIRTUAL GUEST
Appendix F – Guest Common Area
275
Registry of Motor Vehicles – UMS Programmer’s Manual
UGDISPNA DS CL4
INTERNAL DISPATCH NAME
UGDISSAV DS CL24
1ST 24 BYTES FROM LAST HOST CALL
*
UGEDINFO DS 0CL4
EDIT/UTIL INFORMATION FOR UGCEDRTN
UGEDCODE DS H
0=FORCE UPPER CASE
*
1=LICNO EDIT
*
(NOTE, 0-CODE MEANS BYPASS DFLT CONV)
UGEDLENG DS H
OPTIONAL EDIT LENGTH
UGCDCBIN3 DS XL3
3 BYTE BINARY FORMAT
SC0297
ORG
DS CL2
ACCOUNT FOR POOR COUNTING BY STEVE
UGERRDTA DS 0CL54
UGGERRCD DS F
CURRENT PROCESS ERROR-CODE
UGERRMSG DS CL50
ERROR TEXT
* NOTE:
* THE CONTROL-SUPERVISOR WILL SET THE ERROR-CODE AND TEXT TO BINARY
* ZERO BEFORE EXECUTING THE FIRST PROGRAM. THE HOST PROTOCALL PROG* RAM WILL COPY ANY ERROR-CODE FROM THE HOST TO THE ERROR-CODE AREA
* AND RETRIEVE THE TEXT. WHEN THE CONTROL-SUPERVISOR REGAINS CONT* ROL (ON THE OUTPUT SIDE) IT WILL RETRIEVE TEXT IF THE ERROR-CODE IS
===>
Scroll ===> CSR
* NON-ZERO AND THE MESSAGE AREA IS NOT (SPACES OR BINARY-ZEROS)
* THE CONTROL-SUPERVISOR WILL INSURE THAT THE TEXT AREA IS COPIED INTO
* THE MESSAGE AREA FOR THE SCREEN. THE CONTROL-SUPERVISOR WILL SET THE
* THE ALARM BIT IF IT THINKS THAT AN ERROR IS TO BE POSTED (1ST TEXT
* BYTE NON-BLANK). IF IT THINKS THAT THIS AREA ON THE SCREEN IS BLANK
* AND THE INTENT IS TO SEND A BLANK-AREA (1ST 2 BYTES SPACES) IT WILL
* NOT SEND THE FIELD. FOR THESE PURPOSES, SPACES AND BINARY-ZEROS ARE
* TREATED THE SAME IN THE TEXT FIELD.
UGCSRPOS DS XL2
CURSOR POSITION FOR 3270 SERVICES
*
SET TO CURRENT CURSOR POSN BEFORE APPLICATION INVOKED
*
WILL BE USED FOR NEW CURSOR POSITION WHEN SCREEN IS
*
SENT BACK TO TERMINAL
UGCOMBLN EQU *-UGCOMMON
COMMON BASE LENGTH
*
UGCUSERA EQU *
THIS IS THE USER-PROGRAM AREA
DS 2290XL1
PUSH TO PAGE
UGCOMTLN EQU *-UGCOMMON
TOTAL LENGTH
* THE LENGTH OF THIS AREA IS TAKEN FROM THE PROCESS-CONTROL TABLE
* BUT WILL NOT BE LESS THAN THE VALUE OF THE ABOVE EQUATE AT THE LAST
* ASSEMBLY OF UGZ0015P
Appendix F – Guest Common Area
276
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix G:
Functions Descriptions
Page
Screen Name
Screen Description
285
288
290
292
294
296
298
300
302
304
306
308
312
314
316
320
322
325
327
COR
COR1
LH
LI
LN
LNO
LNS
LTH
MRBS
NRL
NRR
R1C
RBS
RH
RI / URI
RNF
RVN / URVN
UMA
UMC
329
UMI9
331
333
335
337
339
341
243
349
352
355
359
UMIQ
UMO
UMON
UMVH
UMVS
UMVI
UP, UR, UL
UPA
UPH
UPIC
UPMV
UPOI
Cash Obligation Resolution Screen
Cash Obligation Resolution Screen
License History Inquiry
License Inquiry Screen
License Number Scroll
License Number Scroll
Social Security Number Scroll
License Transaction History
MRB Sub-menu Screen
Nonrenew display tickets for license
Nonrenew display tickets for registration
Lessee Information
Registration Bank Scroll
Registration History
Registration / Title Inquiry
Corporation Scroll by FID
NADA Value Guide Inquiry
Merit Rating Board - At Fault Insurance Claim
Merit Rating Board - Comprehensive Insurance
Claim
Merit Rating Board - SDIP Statement Input Data
Screen
Same as UMI9 description
Merit Rating Summary - Operator Smmary
Merit Rating Summary - Operator Smmary
Merit Rating Board - Traffic Citation
Merit Rating Board - Traffic Citation
Merit Rating Board - Traffic Citation
UMS subsystem screen
Policy Amend Screen
Policy History screen
Policy Information Screen
Multiple Vehicle Amend Screen
Policy / Operator inquiry screen
Appendix G – Functions Descriptions
277
Registry of Motor Vehicles – UMS Programmer’s Manual
363
366
368
370
372
274
377
380
382
UPTH
RN / URN
URSN
URSR
URSV
UVH
VT
ULP
RA
Policy History Screen
UMS Registration Scroll
Reg/VIN owner scroll screen
Reg scroll by Reg screen
Reg scroll by VIN Screen
Vehicle Policy History Screen
Vehicle Title History
UMS Person Name Scroll
Registration Amend
Appendix G – Functions Descriptions
278
Registry of Motor Vehicles – UMS Programmer’s Manual
COR Function
TITLE:
CASH OBLIGATION RESOLUTION SUMMARY
DESCRIPTION:
The COR function is used to display reg/owner information and
the total amount owed for a registration. To use this screen, the
plate type and reg number must be entered.
This screen can “hop” to RI or UVH by changing the function
code to the desired screen and pressing the F6 key.
COR is modular, written with specific use subprograms, each
being a reusable object. To see how to use any of them, see the
relevant discussion below.
NOTE: A typical use of the COR screen would be to find the total
amount owed against the registration and to look at the details by
hopping to COR1.
COMPONENTS:
Guest input program
UGS1191P
501191001
501191002
501191003
501191004
501191005
501191006
501191007
Enter Keys
Invalid Function Key
No surrogate - F4 F6
No surrogate F9
Key change required
Registration select required
No F9 surrogate
Guest output program
UGS1192P
501192001
Press F9
Host program(s)
UHS1193P
501193001
501193002
501203014
501193003
501193004
501193005
Bad link to UHS1194P
Bad link to UHS1195P
Bad link to UHS1197P
Bad link to UHS1198P
Bad link to UHS1199P
Bad link to Message Log
UHS1194P
501194001
501194002
Bind Error
Inquiry complete
Appendix G – Functions Descriptions
279
Registry of Motor Vehicles – UMS Programmer’s Manual
501194003
501194004
Inquiry Failed
Key not found
UHS1195P
501195001
501195002
501195003
501195004
Bind Error
Too many actions
Inquiry Complete
Inquiry Failed
UHS1196P
501196001
501196002
501196003
501196004
Bind Error
Too many actions
Inquiry Complete
Inquiry Failed
UHS1197P
501197001
501197002
501197003
501197004
Bind Error
Too many tickets
Inquiry Complete
Inquiry Failed
UHS1198P
501198001
501198002
501198003
501198004
Bind Error
Too many citations
Inquiry complete
Inquiry Failed
UHS1199P
501199001
501199002
501199003
501199003
Bind Error
Too Many MSCOS
Inquiry Complete
Inquiry Failed
Lr
UHS1194L
UHS1195L
UHS1198L
UHS1199L
Map
UGS1190M
Lx table
UGS1190T
Appendix G – Functions Descriptions
280
Registry of Motor Vehicles – UMS Programmer’s Manual
Copy books
UGZCOMMY
UHZCOMMY
UIS119AY
UHRREGSY
UILXCNST
UHUILOGY
UHS1194Y
UHS1195Y
UHS1196Y
UHS1197Y
UHS1198Y
UHS1199Y
UGS120AY
UIR1240Y
MREYIOWK
UHS1197Y
UHS1196Y
(UGS1191P, UGS1192P)
(UHS1193P)
(UGS1191P, UGS1192P,
UHS1193P, UHS1194P)
(UHS1193P)
(UGS1192P)
(UHS1193P, UHS1194P, UHS1195P,
UHS1197P, UHS1198P, UHS1199P)
(UHS1193P, UHS1194P)
(UHS1193P, UHS1195P)
(UHS1196P)
(UHS1197P)
(UHS1193P, UHS1198P)
(UHS1193P, UHS1199P)
(UGS1191P)
(UGS1191P)
(UMS1193P)
(UHS1193P, UHS1197P)
(UHS1194P)
External name
COR
Internal name
COR2 (to access by reg)
COR1, COR3, URSR
AVAILABLE FUNCTION KEYS:
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 -
Main Menu
UMS menu
Not available
Not available
Not available
Screen hopping
Not available
Not available
Hop to COR1 for details
Not available
Not available
Not available
NOTE: F6 requires function change
Appendix G – Functions Descriptions
281
Registry of Motor Vehicles – UMS Programmer’s Manual
COR1 Function
TITLE:
CASH OBLIGATION RESOLUTION DETAIL
DESCRIPTION:
The COR1 function is used to display detail information with the
amounts owed and the total amount owed for a registration. To
use this screen, first enter COR, then press F9. No function code
change is needed.
COR1 is also modular, calling the various subprograms as needed.
This screen can “hop” to RI or UVH by changing the function code
to the desired screen and pressing the F6 key.
This screen can “hop” to an appropriate screen, such as the CIC
screen, for a citation by changing the function code, putting the
cursor on the appropriate line, and hitting enter.
To return to COR, simply press F9 again.
NOTE: A typical use of the COR1 screen would be to display all
the items that cause a fee to be owed against the registration.
COMPONENTS:
Guest input program
UGS1201P
Guest output program
UGS1202P
Host program(s)
UHS1120P
Lr
UHS1195L
UHS1196L
UHS1197L
UHS1198L
UHS1199L
UHS1190L
Map
UGS1200M
Lx table
UGS1200T
Appendix G – Functions Descriptions
282
Registry of Motor Vehicles – UMS Programmer’s Manual
Copy books
UGZCOMMY
UHZCOMMY
UGS120AY
UGS120BY
UIS120CY
UHRREGSY
UILXCNST
UHUILOGY
UHS1195Y
UHS1196Y
UHS1197Y
UHS1198Y
UHS1199Y
UHS1190Y
(UGS1201P, UGS1202P)
(UHS1203P)
(UGS1201P, UGS1202P)
(UGS1201P, UGS1202P, UHS1203P)
(UHS1203P)
(UHS1203P)
(UGS1202P)
(UHS1195P, UHS1196P, UHS1197P,
UHS1198P, UHS1199P, UHS1190P)
(UHS1203P, UHS1195P)
(UHS1203P, UHS1196P)
(UHS1203P, UHS1197P)
(UHS1203P, UHS1198P)
(UHS1203P, UHS1199P)
(UHS1203P, UHS1190P)
External name
COR1
Internal name
COR4 (to access by reg)
AVAILABLE FUNCTION KEYS:
F1 - Main Menu
F2 - UMS subsession
F3 - Not available
F4 - Screen hopping
F5 - Not available
F6 - Screen hopping
F7 - Page backward
F8 - Page forward
F9 - Return to COR
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F6 and F4 require function change
Appendix G – Functions Descriptions
283
Registry of Motor Vehicles – UMS Programmer’s Manual
LH Function
TITLE:
LICENSE HISTORY INQUIRY
DESCRIPTION:
The LH function is used to request the history of a persons name
and license number changes. Note that a change in a person’s date
of birth is considered the same as a change of name. The screen
displays the last three name changes as well as the last eight
license numbers held by that person. For Commercial Drivers, the
LH “Extension Screen” (LHE), which can only be accessed from
LH, will display CDL-specific endorsement and restriction data.
COMPONENTS:
Guest input program
UGL0060P
Guest output program(s)
UGL0061P
UGL0062P
Host program(s)
UHL0060P
UHL0070P
UHL0080P
UHL0095P
Map
UGL0060M
UGL0062M
Copy books
UGZCOMMC
LI06
REGEQU
UGZCOMMA
UMZCOMMA
UGTRTABL
(UGL0060P, UGL0061P)
(UGL0061P, UGL0060C)
(UGL0062P)
(UGL0062P)
(UGL0062P)
(UGL0062P)
External name
LH
Internal name
LH10 (Person lookup via current and previous Mass license)
LH20 (Person lookup via non-Mass license)
LH30 (Person lookup via pers-surrogate number)
Appendix G – Functions Descriptions
284
Registry of Motor Vehicles – UMS Programmer’s Manual
LH40 (Endorsement and restriction lookup via surrogate number
for LHE only)
AVAILABLE FUNCTION KEYS:
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 -
End session
Main Menu
Not available
Not available
Not available
Jump to screen
Not available
Not available
Not available
Not available
Rescroll
Not available
Appendix G – Functions Descriptions
285
Registry of Motor Vehicles – UMS Programmer’s Manual
LI Function
TITLE:
UNIQUE LICENSE INQUIRY SCREEN
DESCRIPTION:
The LI function is used to request information pertaining to a
current or previous driver’s license number. It obtains personal
information (name, mailing address and residence) as well as
restriction data, previous name, license status, endorsements, and
placard information.
COMPONENTS:
Guest input program
UGL1070P
200001004 - Invalid previous indicator enter X
200001005 - LI screen displayed please proceed
200001016 - Invalid Social Security Number
105003001 - Invalid Mass license
105006003 - License invalid
200001006 - License number not found
108000002 - State invalid
200001014 - Social security number must be numeric
906002012 - Social security number not found
213000012 - Enter License Number or SSN
Guest output program
UGL1071P
200001007 - Inquiry process complete
230001002 - Unable to obtain endorsements date. . .try
again
230001003 - Unable to obtain cell data. . .try again
212017129 - Gen. Permit exp date: Request blu field is in
error
Host program(s)
LI07 Lic Inquiry by Lic# UHL0070P
LI08 Lic Inquiry by OOS# UHL0080P
LI09 Lic Inquiry by SSN UHL0090P
LI10 Lic Inquiry by Surrogate
UHL0100P, UHL0110P
LI12 Endorsement Inquiry by Surrogate UHL0120P
LB10 Generalized Fetcher of Brefs UHL0420P
PR05 Passenger Restriction Inquiry UHL3205P
LI96 Generate expiration date (only permit for) UHL0960P
LXP1 PDPS Pers-Ext Type “6” Lookup
UHL0610P
Map
UGL1070M
Appendix G – Functions Descriptions
286
Registry of Motor Vehicles – UMS Programmer’s Manual
Copy books
UGZCOMMC
UGL1070G
UMLLI12O
UMSLXZT
UMLLB10O
UMLLB10R
UMLLI12R
UMLLXP1R
UMLLXP1O
UMLPR0SR
UMLPR0SO
UMLLI96R
UMLLI96O
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1071P)
(UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
(UGL1070P, UGL1071P)
LX table
UGL1070T
External name
LI
Internal name
LI07 (Person lookup via current and previous Mass license)
LI08 (Person lookup via non-Mass license)
LI09 (Person lookup via social security number)
LI10 (Person lookup via person surrogate number)
AVAILABLE FUNCTION KEYS:
F1 - Main Menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Jump to screen
F7 - Not available
F8 - Not available
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
287
Registry of Motor Vehicles – UMS Programmer’s Manual
LN Function
TITLE:
LICENSE NUMBER SCROLL
DESCRIPTION:
The LN function is used to display any duplicate license numbers
in the system. The license number is a required field. This
function is invoked in one of two ways:
♦ By entering LN in the function field
♦ Automatically, when a duplicate license number is
detected by any of the other licensing functions.
Once LN is invoked by another function, the user can return to the
original function by positioning the cursor at the desired license
information and pressing F9. Up to 7 licenses display per page.
COMPONENTS:
Guest input program
UGL0020P
202001004 - First record displayed
202001001 - License number is invalid
202001003 - End of set encountered
Guest output program
UGL0021P
202001003 - End of set encountered
Host program(s)
UHL0020P - License Number Scroll
Map
UGL0020M
Copy books
REGEQU
UGZCOMMA
UHZCOMMA
UGTRTABL (UGL0020P)
External name
LN
Internal name
LI04
Appendix G – Functions Descriptions
288
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1
F2
F3
F4
F5
F6
F7
F8
F9
- Main Menu
- UMS Submenu screen
- Not available
- Select from scroll screen
- Not available
- Not available
- Page backward
- Page forward
- Select from scroll and refresh
previous screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
289
Registry of Motor Vehicles – UMS Programmer’s Manual
LNO Function
TITLE:
OUT-OF-STATE LICENSE NUMBER SCROLL
DESCRIPTION:
The LNO function displays any duplicate out-of-state license
numbers in the system. License number and state are required
fields. The LNO function is invoked in one of two ways:
♦ By entering LNO in the function field
♦ Automatically, when a duplicate out-of-state license
number is detected by any of the other licensing
functions.
When LNO is invoked by another function, the user can return to
the original function by positioning the cursor at the desired license
information and pressing F9. Up to 7 licenses display per page.
COMPONENTS:
Guest input program
UGL0240P
105009001 - Value invalid
202001003 - End of set encountered
202001004 - First record displayed
Guest output program
UGL0241P
203001002 - No records for this key
on database
Host program(s)
UHL0520P - LD08 Duplicate OOS Scroll
Map
UGL0240M
LX table
UGL0240T
Copy books
UMSLXMAC
REGEQU
UGZCOMMA
UGL0240C
UHZCOMMA
UGTRTABL (UGL0240P)
Appendix G – Functions Descriptions
290
Registry of Motor Vehicles – UMS Programmer’s Manual
External name
LNO
Internal name
LD08
AVAILABLE FUNCTION KEYS:
F1
F2
F3
F4
F5
F6
F7
F8
F9
- Main Menu
- UMS Submenu Screen
- Not available
- Select from scroll Screen
- Not available
- Not available
- Page backward
- Page forward
- Select from scroll and refresh
previous screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
291
Registry of Motor Vehicles – UMS Programmer’s Manual
LNS Function
TITLE:
SOCIAL SECURITY NUMBER SCROLL
DESCRIPTION:
The LNS function displays any duplicate social security numbers
in the system. LNS is invoked in one of two ways:
♦ By entering LNS in the function field
♦ Automatically, when a duplicate social security number
is detected by any of the other licensing functions.
When LNS is invoked by another function, the user can return to
the original function by positioning the cursor at the desired social
security number information, and pressing F9. Up to 7 social
security numbers display per page.
COMPONENTS:
Guest input program
UGL0220P
202001004 - First record displayed
105009001 - Invalid social security number
202001003 - End of set encountered
Guest output program
UGL0221P
202001003 - End of set encountered
Host program(s)
UHL0500P - LD04 Duplicate SSN Scroll
203001002 - No records for this key on database
Map
UGL0220M
LX table
UGL0220T
200001016 - Invalid Social Security Number
Copy books
UMSLXMAC
REGEQU
UGZCOMMA
UGL0220C
UHZCOMMA
UGTRTABL (UGL0220P)
Appendix G – Functions Descriptions
292
Registry of Motor Vehicles – UMS Programmer’s Manual
External Name
LNS
Internal Name
LD04
AVAILABLE FUNCTION KEYS:
F1
F2
F3
F4
F5
F6
F7
F8
F9
- Main Menu
- UMS Submenu screen
- Not available
- Select from scroll screen
- Not available
- Not available
- Page backward
- Page forward
- Select from scroll
and refresh previous screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
293
Registry of Motor Vehicles – UMS Programmer’s Manual
LTH Function
TITLE:
LICENSE TRANSACTION HISTORY
DESCRIPTION:
LTH provides a list of all transactions, along with transaction
history, associated with a license. Each transaction displays the
transaction date, associated fee, batch number, and explanation of
the transaction code. This function also includes summarized cash
records, NDR BREF records, transaction codes and descriptions, in
addition to the license holder’s name, address, and date of birth.
All changes made on the LC screen are displayed, as well as all
changes to date.
The LTH function is invoked by entering LTH in the FUNCTION
field. Up to 15 transactions are displayed per page.
COMPONENTS:
Guest input program
UGL0260P
206003001 - Function key or enter invalid
at this time
200001016 - Lic# or SS# required
206003008 - F7 invalid beginning of set
206003009 - F8 invalid at end of set
206003010 - Phase count-internal error
Guest output program
UGL0261P
200004001 - Logic internal error
206004002 - No history records for this
person
Host program(s)
UHL0070P (LI07)
UHL0080P (LI08)
UHL0100P (LI10)
UHL0110P
UHL0420P (LB10 - BREFS)
208003001 - Bind error
208003002 - Ready error
Map
UGL0260M
LX table
UGL0260T
Appendix G – Functions Descriptions
294
Registry of Motor Vehicles – UMS Programmer’s Manual
200001016 - Invalid Security Number
Transaction code table
UGL0262P - Bref description table
Copy books
UMSLXMAC
REGEQU
UGZCOMMA
UGL0260C
UHZCOMMA
External name
LTH
Internal name
LI07/LB10 or LI08/LB10
AVAILABLE FUNCTION KEYS:
F1 - Main Menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Next function with current key
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
295
Registry of Motor Vehicles – UMS Programmer’s Manual
MRBS Function
TITLE:
MRB DUPLICATE LICENSE SCROLL
DESCRIPTION:
The MRBS function displays any duplicate license numbers, both
MA and out-of-state, in the system. This function differs from the
LN function in that it makes no distinction between current and
previous license numbers when displaying duplicates.
Additionally, if the keywords “NOLICENSE” for license and
“XX” for license state are used, the MRBS function will accept a
name and date of birth which limits the display to only those
“nolicense” person records that match. As an added bonus on
NOLICENSE, if the date of birth is null and the name begins with
an ‘*’, the display will show a list of all companies with names that
match.
The MRBS function can only be invoked by another function for
duplicate resolution. The user can then return to the original
function by positioning the cursor at the desired person/company
information and pressing F9. Up to seven persons/companies are
displayed per page.
COMPONENTS:
Guest input program
UGM0001P
Guest output program
UGM0002P
Host program(s)
UHM0002P
Map
UGM0001M
LX Table
UGM0001T
Copy books
UMSLXZT
UGZCOMMC
UGM0001C
UHZCOMMY
External name
MRBS
Appendix G – Functions Descriptions
296
Registry of Motor Vehicles – UMS Programmer’s Manual
Internal name
MRBX
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Select from scroll and refresh previous screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
297
Registry of Motor Vehicles – UMS Programmer’s Manual
NRL Function
TITLE:
NONRENEW DISPLAY TICKETS FOR LICENSE
DESCRIPTION:
The NRL function is used to review all of the outstanding tickets
and/or excise bills for a license number.
When the license is entered, NRL will display unpaid parking
tickets, abandoned vehicle citations, or excise bills marked against
the license.
This function displays the license number, state, the license
holder’s date of birth, license holder’s last name, first name,
middle name, number of items marked against this particular
license, the three digit code and name for each town that marked a
ticket or bill for the license, the type of outstanding obligation
marked (abandoned vehicle citation, excise non-payment or unpaid
parking tickets), the year of the outstanding obligation, and the
numbers or alphabetic characters assigned to the ticket or bill.
The NRL function is invoked by entering NRL in the FUNCTION
field.
COMPONENTS:
Guest input program
UGN0040P
220002000 - Enter license
206003010 - Phase count - internal error
206003001 - Function key or enter invalid at this time
220002001 - F7 invalid-beginning of set
220002002 - F8 invalid-end of set
Guest output program
UGN0041P
226004001 - Logic internal - error
220002003 - End of set
Host program (s)
UHL0100P - LI10 - License inquiry by surrogate number
UHL0110P
UHL0070P - LI07 – License inquiry by license number
UHL0080P - LI08 – License inquiry by OOS number
UHN0040P - NR40 – Nonrenew indexed ticket inquiry
Map
UGN0040M
Appendix G – Functions Descriptions
298
Registry of Motor Vehicles – UMS Programmer’s Manual
LX table
UGN0040T
Copy books
UMSLXMAC
REGEQU
UGZCOMMA
UGN0040C
UHZCOMMA
External name
NRL
Internal name
NR40
AVAILABLE FUNCTION KEYS:
F1 - Main menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Next function with current key
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
299
Registry of Motor Vehicles – UMS Programmer’s Manual
NRR Function
TITLE:
NONRENEW DISPLAY TICKETS FOR REGISTRATION
DESCRIPTION:
The NRR function is used to review all of the outstanding tickets
and/or excise bills for a registration number.
After a plate type, registration number, and plate color (optional)
are entered NRR will display each parking ticket, abandoned
vehicle ticket, or excise bill currently marked.
This function displays the current plate color (if it was not
entered), manufacturer’s vehicle identification number indicating
the vehicle marked for non-renewal, vehicle year, manufacturer’s
description of the vehicle, owner’s last name, first name, middle
name, number of items marked against a particular registration, the
three digit code and name for each town that marked a ticket or bill
for the registration, the type of outstanding obligation marked
(abandoned vehicle citation, excise non-payment or unpaid parking
tickets), the year of the outstanding obligation, and the numbers or
alphabetic characters assigned to the ticket or bill.
The NRR function is invoked by entering NRR in the FUNCTION
field.
COMPONENTS:
Guest input program
UGN0020P
220001000 – Enter registration
206003010 - Phase count – internal error
206003001 - Function key or enter invalid at this time
220001001 – F7 invalid-beginning of set
220001002 - F8 invalid-end of set
Guest output program
UGN0021P
226004001 - Logic internal - error
220001003 - End of set
Host program (s)
UHR1063P - URI5 – Registration inquiry by reg number
UHR1067P
UHN0040P – NR40 – Nonrenew indexed ticket inquiry
Appendix G – Functions Descriptions
300
Registry of Motor Vehicles – UMS Programmer’s Manual
Map
UGN0020M
LX table
UGN0020T
Copy books
UMSLXMAC
REGEQU
UGZCOMMA
UGN0020C
UHZCOMMA
External name
NRR
Internal name
NR40
AVAILABLE FUNCTION KEYS:
F1 - Main menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Next function with current key
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
301
Registry of Motor Vehicles – UMS Programmer’s Manual
R1C Function
TITLE:
R1C SCREEN
DESCRIPTION:
The R1C screen is used to inquire on, add, change, or delete lessee
information associated with a registration. The required key data
fields are plate type and registration number. The plate color is
optional and, if not entered, will become the default color for the
plate type entered. The screen will display the lessee’s license/fid
number, name, address, and the lease effective date. The vehicle
owner’s name and address will also be displayed, along with the
vehicle information.
There are 4 actions that can be processed on this screen. They
include “I,” Inquiry; “A,” Add; “C,” Change; and “D,” Delete.
All the actions require a registration to be entered. If there are
duplicate records on the database for the registration entered, a
screen of duplicate key choices is displayed to allow the user to
select the desired record.
In addition to the user going directly to the R1C screen, the
R1A/R1B process will pass the user to R1C whenever a tax
exempt code of “L” is entered. In this situation, the registration
information is passed and the only action allowed is “A.” Once the
lessee information is entered, the user is passed back to the R1B
screen.
To process a lessee inquiry, an action code of “I” is entered with
the required key data fields.
To process a lessee add, an action code of “A” is entered with the
required key data fields. Once the vehicle and owner information
is retrieved and displayed, the user is required to enter the primary
lessee information. If the lessee is an individual, then the license
number must be entered. The license state is only needed when the
license number is not from Massachusetts. If the license number is
not on the database, the user is allowed to add it by supplying the
lessee’s name, date of birth, and mailing address. The residence
address is optional. If the license is a duplicate on the database,
then a duplicate resolution screen will be displayed. Optionally,
the user may enter the lessee’s name and date of birth. A screen
displaying matching names will be displayed, allowing the user to
select the desired record. If the lessee is a corporation, then an FID
number must be entered. If the FID is not on the database, the user
Appendix G – Functions Descriptions
302
Registry of Motor Vehicles – UMS Programmer’s Manual
will receive an error message that it was not found. If the FID is a
duplicate on the database, then a duplicate resolution screen will be
displayed. A secondary lessee may also be entered. The
secondary lessee can only be an individual. If the license number
entered for the secondary lessee is not found, it will be added using
the same address information as for the primary lessee. For an
individual lessee, the garage code is optional and, if not entered,
will default to the lessee’s mailing city. For a corporation lessee,
the garage code must be entered. Other fields that may be entered
are insurance company number and lease effective date. If the
lease effective date is not entered, it will default to the current date.
The F12 key is used to apply the updates to the database.
To process a lessee change, an action code of “C” is entered with
the required key data fields. When the lessee record has no
secondary lessee and the primary lessee is a corporation, the user
will only be able to add a secondary lessee. When the lessee
record has no secondary lessee and the primary lessee is an
individual, the user can add an FID number (this will make the
individual the secondary lessee) or add a secondary lessee. When
the lessee record has a primary and secondary lessee, the user can
EOF the primary lessee (making the secondary lessee the primary
lessee) or change the secondary lessee. Other fields that may be
changed are garage code, insurance company code, lease effective
date, and lease end date. When the lease end date is entered, the
lease is considered to have ended.
To process a lessee delete, an action code of “D” is entered with
the required key data fields. The system will then require the user
to press F12 twice to delete the record. This action should only be
used to delete a lessee record that was entered in error. The change
action should be used to end a lease.
Inquiry actions are allowed for all users. A user must obtain
authorization to perform add/change actions and delete actions.
The F6 key can be used for screen hopping. The user will be able
to screen hop to screens that have a registration, license, or FID
number as their primary key. For example, the user may F6 to RI
using the displayed registration or F6 to LI using the displayed
lessee’s license number.
The F9 key is used to resolve duplicates from registration, license,
and nown scroll screens.
Appendix G – Functions Descriptions
303
Registry of Motor Vehicles – UMS Programmer’s Manual
The F12 key will perform database updates. In the case where
R1A/R1B transfers the user to R1C, the F12 key will return the
user to R1B, and that program will perform the database updates.
COMPONENTS:
Guest input program
UGR2301P
Guest output program
UGR2302P
Host programs
UHR2303P, UHR2304P
Map
UGR2300M
LxTable
UGR2300T
Copy books
UGZCOMMY (UGR2301P, UGR2302P)
UHZCOMMY (UHR2303P)
UIR230AY (UGR2301P, UGR2302P, UHR2303P)
UIR230BY (UHR2303P, UHR2304P) UIR219BY (UHR2303P)
UIR219CY (UGR2302P)
UIR219DY (UGR2301P)
UILXCNST (UGR2301P, UGR2302P, UHR2303P)
UHUILOGY (UHR2303P)
UIR1OWNY (UHR2303P)
UIR1510Y (UHR2303P)
UHR1VISY (UHR2303P)
UHRREGSY (UHR2303P)
UHR1ALGY (UHR2304P)
MREYIOWK (UHR2303P, UHR2304P)
MREYEDIT (UHR2303P)
MRMYZIPM (UHR2303P)
MCCYPOST (UHR2304P)
MUMYOREG (UHR2304P)
External name
R1C
Internal name
R116
Appendix G – Functions Descriptions
304
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Main Menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen Hopping
F7 - Not available
F8 - Not available
F9 - Resolves duplicates from Registration,
License and Nown scroll screens
F10 - Not available
F11 - Not available
F12 - Update
Appendix G – Functions Descriptions
305
Registry of Motor Vehicles – UMS Programmer’s Manual
RBS Function
TITLE:
REGISTRATION BANK SCROLL
DESCRIPTION:
The RBS function is used to review a list of lienholder information
by lienholder code or name, with the lienholder type as an optional
secondary key. Code and name cannot both be entered, and the
code must be greater than zero and less than 32768.
COMPONENTS:
Guest input program
UGR2201P
323001001
323001002
323001003
323001004
323001005
323001006
323001007
323001008
323001009
323001010
323001011
323001012
323001013
323001014
323001015
323001016
Enter keys
Entry not valid
Enter error
End of set
Top of set
Invalid type
Can’t have both
Must have one
Leading spaces
Embedded spaces
Alphanumeric only
Code too large
Code not numeric
Invalid state
Invalid zip
Second key invalid
Guest output program
UGR2202P
323001020
F8 for more
323001021
No more records
323001022
Resolve duplicates
Host program
UHR2203P
323001025
323001026
323001027
323001028
323001029
323001030
323001031
323001032
323001033
LR error
DML error
No record for key
Invalid key
Can’t have both
Must have one
Leading space
Embedded spaces
Alphanumeric only
Appendix G – Functions Descriptions
306
Registry of Motor Vehicles – UMS Programmer’s Manual
Map
UGR2200M
Copy books
UILXCNST (ALL)
UGZCOMMY(UGR2201P, UGR2202P)
UHZCOMMY(UHR2203P)
UGR220AY (UGR2201P, UGR2202P)
UGR220BY (UGR2201P)
UIR220CY (UGR2202P, UHR2203P)
UHUILOGY (UHR2203P)
External name
URBS
Internal name
BS02
AVAILABLE FUNCTION KEYS:
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 -
End session
UMS Main Menu
Not available
Not available
Not available
Not available
Page forward
Page backward
Select from scroll screen
Not available
Not available
Not available
Appendix G – Functions Descriptions
307
Registry of Motor Vehicles – UMS Programmer’s Manual
RH Function
TITLE:
REGISTRATION HISTORY
DESCRIPTION:
The RH function is used to display a registration’s owner and
vehicle information. Both the current vehicle and any previous
vehicles that were attached to the registration are displayed. The
key fields (fields to be entered) are plate type, registration number,
and color. All three fields are required. If color is not entered, a
default color is assumed based on the other two fields.
Note: A typical use of this screen would be to find all vehicles that
were attached to a specific registration.
Multiple pages may be displayed on this screen by using the
standard F7 and F8 for page forward and back.
This screen can be “hopped” from to a UMS screen (eg. RI) or an
ALAR screen (eg. TH). To transfer to another screen and carry
either the registration or vehicle information, the user can cursor
down, select the desired detail line and press F4.
After transferring to a non-scroll screen the rescroll option is
available to return to RH by changing the function back to RH and
pressing the F11 key.
COMPONENTS:
Guest input program
UGR1251P
326001001
326001002
326001003
326001004
326001005
Enter keys
No surrogate F4
F7 not valid
No more records
Entry not valid
Guest output program
UGR1252P
326002001
F8 for more
326002002
No more records
Host program
UHR1253P
326003000
326003001
326003002
No key data
No VEHR on VEHC
LR error
Appendix G – Functions Descriptions
308
Registry of Motor Vehicles – UMS Programmer’s Manual
326003003
326003004
326003005
326003006
326003009
326003010
326003011
326003012
No registration found
Owner missing
DBKEY error
Invalid entry key
Invalid DBKEY
Bind error
Bad link registration status
Vehicle not found, get registration
Map
UGR1250M
Copy books
UILXCNST
UGZCOMMY
UHZCOMMY
UGR125AY
UGR125BY
UIR125CY
UHUILOGY
UHRREGSY
MREYIOWK
(UGR1251P,UGR1252P)
(UGR1251P,UGR1252P)
(UHR1253P)
(UGR1251P, UGR1252P)
(UGR1251P)
(UGR1252P, UHR1253P)
(UHR1253P)
(UHR1253P)
(UHR1253P)
External name
RH
Internal name
RH01
AVAILABLE FUNCTION KEYS:
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 -
End session
UMS Menu
Not available
Cursor select from scroll screen
Not available
Not available
Page forward
Page backward
Not available
Not available
Rescroll
Not available
Appendix G – Functions Descriptions
309
Registry of Motor Vehicles – UMS Programmer’s Manual
URI Function
TITLE:
REGISTRATION/TITLE INQUIRY
DESCRIPTION:
The URI function is used to inquire on registration and title
information. The inquiry is done by entering one or more of the
following keys:
♦
♦
♦
♦
Plate type and registration
Vehicle identification number (VIN)
Title number
License number
At least one of these keys must be entered. The inquiry searches
for an exact match on the information entered. If an exact match is
not found, an error message displays back to the user indicating no
data was found. If a duplicate is encountered for a registration
number, processing is transferred to the Reg Scroll by Registration
screen (URSR) to resolve the duplicate. If a duplicate is
encountered for a VIN, the processing is transferred to the Reg
Scroll by VIN screen (URSV). If a duplicate is encountered for a
license, processing is transferred to the License Number Scroll
screen (LN).
To resolve a duplicate from one of the duplicate resolution screens,
the user can move the cursor down to select the desired line by
pressing either the F4 or F9 key. There is no difference between
the F4 and F9 key except the user needs to change the function
code to URI before pressing the F4 key.
NOTE: A typical use of the URI function would be to find the
registration, title and vehicle information associated with a given
key.
COMPONENTS:
Guest input program
UGR5061P
311001021 - No surrogate for F4
311001022 - Entry not valid
311001002 - Enter keys
311001001 - Last 6 characters numeric
311001038 - Invalid VIN
Appendix G – Functions Descriptions
310
Registry of Motor Vehicles – UMS Programmer’s Manual
Guest output program
UGR5062P
311001003 - Inquiry process complete
311001037 - Error when confirming registration
311001018 - Duplicate registration
311001019 - Duplicate confirm registration
Host program(s)
UHR5063P
311001007 - Entry not found
311001008 - Database error
311001009 - IDMS-Error
311001018 - Duplicate information
311001039 - No duplicate listing
311001040 - Clerk not found
311001041 - CLRK IDMS error
311001042 - CLRK-IO-Error
311001043 - Office type not found
311001044 - Office type IDMS-Error
311001045 - Office type IOError
315063001 - UHRSREGS link error
315063005 - Bind match VEHR
315063010 - Vehr match not found
315063015 - Match VEHR IO error
315063020 - Bind RSLT error
315063030 - RSLT IO error
UHR5064P
311001010 - A record matching entered key was not found
311001011 - Database error
311001012 - IDMS error
311001039 - No duplicate list
311001040 - Clerk not found
311001041 - CLRK IDMS error
311001042 - CLRK IO error
311001043 - Office type not found
311001044 - Office type IDMS error
311001045 - Office type IO error
315063035 - BIND MTCH VEHC
315063040 - MTCH VEHC not found
315063045 - MTCH VEHC Io error
315063050 - BIND RSLT error
315063055 - RSLT not found
315063060 - RSLT IO error
Appendix G – Functions Descriptions
311
Registry of Motor Vehicles – UMS Programmer’s Manual
UHR5065P
311001013 - Entry not found
311001014 - I/O error
311001015 - IDMS error
311001039 - No duplicate list
311001040 - Clerk not found
311001041 - CLRK IDMS error
311001042 - CLRK I/O error
311001043 - Office type not found
311001044 - Office type IDMS error
311001045 - Office type I/O error
315063065 - BIND PERS
315063070 - PERS not found
315063075 - PERS I/O error
315063080 - BIND MTCH VEHR
315063085 - MTCH VEHR not found
315063090 - MTCH VEHR I/O error
315063095 - BIND RSLT error
315063100 - RSLT not found
315063105 - RSLT I/O error
UHR5066P
311001001 - Duplicate title
311001004 - Entry not found
311001005 - I/O error
311001006 - IDMS error
315063110 - BIND MTCH VEHC
315063115 - MTCH VEHC not found
315063120 - MTCH VEHC I/O error
315063125 - BIND RSLT error
315063130 - RSLT not found
315063135 - RSLT I/O error
UHR5067P
311001004 - Bad program call
311001016 - LR error
311001017 - DML error
311001013 - Record keys not found
311001046 - Inactive revocation
Map
UGR5060M
LX table
UGR5060T
Appendix G – Functions Descriptions
312
Registry of Motor Vehicles – UMS Programmer’s Manual
Copy books
UGZCOMMY(ALL)
UIR5060Y
(UGR5061P, UGR5062P, UHR5063P, UHR5064P,
UHR5065P, UHR5066P, UHR5067P)
MREYBRAN (UHR5067P)
MREYRCOD (UHR5067P)
MREYMYSY (UHR5063P)
MREYMYWY(UHR5063P)
UIR5067Y
(UHR5067P)
UHUILOGY (UHR5063P, UHR5064P, UHR5065P, UHR5066P,
UHR5067P)
UHRREGSY (UHR5067P)
UHRTTLSY (UHR5067P)
UGRIBLKY (UGR5061P)
MREYIOWR (UHR5063P)
External name
URI
Internal name
URIK, URIL, URIM, URIN
AVAILABLE FUNCTION KEYS:
F1
F2
F3
F4
F5
F6
- End session
- UMS Menu
- Not available
- Select from scroll screen
- Not available
- Transfer key information to selected
screen
F7 - Not available
F8 - Not available
F9 - Select from scroll screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
313
Registry of Motor Vehicles – UMS Programmer’s Manual
RNF Function
TITLE:
CORPORATION SCROLL BY FID
DESCRIPTION:
The RNF function is used to request and display a list of
corporations by Federal ID (FID). The key fields (fields to be
entered) are FID and Zip Code. The FID field is the only required
field. The Zip Code field is optional, but may be used to narrow
the search.
NOTE:
A typical use of this screen would be to find the corporation if the
FID is known.
Multiple pages may be displayed on this screen by using the
standard F7 and F8 for page forward and back.
This screen can be “hopped” to from a UMS screen (eg. R1A) or
an ALAR screen (eg. OP1, RNM or RP) when a duplicate FID is
encountered. To transfer control back with the FID information,
the user can cursor down, select the desired FID and press F9.
COMPONENTS:
Guest input program
UGR1231P
322001001 - Invalid entry
322001002 - Enter keys
322001003 - Enter error
322001004 - Enter FID
322001005 - Zip not numeric
322001006 - Beginning of set
322001007 - End offset
322001008 - Zip 1 required
322001009 - Invalid FID
Guest output program
UGR1232P
322001070 - No more records
322001071 - F8 for more
Host program
UHR1233P
322001041 - Bad access indicator
322001042 - No matching records
322001043 - NOWN not found for surrogate
322001044 - DBKEY not found
322001045 - LR-error
Appendix G – Functions Descriptions
314
Registry of Motor Vehicles – UMS Programmer’s Manual
322001046 - DML error
322001047 - Database error
322001048 - NOWN not found for surrogate
322001049 - LR logic error
322001051 - Bad first time indicator
Map
UGR1230M
Copy books
UILXCNST (UGR1231P)
UGZCOMMY(UGR1231P, UGR1232P)
UHZCOMMY(UHR1233P)
UGR123AY (UGR1231P, UGR1232P)
UGR123BY (UGR1231P)
UIR123CY (UGR1232P, UHR1233P)
UHUILOGY (UHR1233P)
External name
RNF
Internal name
UR09
AVAILABLE FUNCTION KEYS:
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 -
End session
UMS menu
Not available
Not available
Not available
Not available
Page forward
Page backward
Select from scroll screen
Not available
Rescroll
Not available
Appendix G – Functions Descriptions
315
Registry of Motor Vehicles – UMS Programmer’s Manual
URVN Function
TITLE:
National Automobile Dealers Association (NADA) Inquiry
DESCRIPTION:
The URVN function is used to display NADA information related
to a vehicle identification number (VIN). The user must enter the
VIN to use this screen. However, the model year and the make
fields are required if the model year of the vehicle is prior to 1981.
The URVN screen allows the user to inquire on the NADA ValuGuide, giving the vehicle’s weight, MSRP, loan value, retail value,
trade-in value, series, submake, and style.
This screen can be “hopped” to from URI/UVH using F6, from
UPA using F3, or from URSR/URSV/URSN with an F4 cursor
select.
When the user has been transferred to the URVN screen by
pressing the F4 or F9 key on a scroll screen (e.g. URSR screen),
the user may return to the scroll screen in order to make a new
selection. This is done by changing the function code to the
appropriate scroll screen’s function and pressing the F11 key.
When the user has been transferred to the URVN screen by
pressing the F3 key on a cursor select screen (e.g. UPA screen), the
user may return to the cursor select screen in order to make a new
selection by simply pressing the F11 key.
When a tape of a new UMS release is sent to insurance companies,
they have 60 days to make changes to the guest software and maps
to make the applications more suitable to their individual business
needs. For this reason, it is necessary to maintain two versions of
the software. During these 60 days, the old version of URVN may
be accessed by entering the function code “TRVN,” while the
function code “URVN” will execute the recently modified
modules. After the 60-day period, TRVN will no longer be
available.
NOTE: A typical use of the URVN screen would be to find
NADA information related to a VIN.
COMPONENTS:
Guest input program
UGR2141P
314001001 - VIN Required
314001002 - Year not numeric
Appendix G – Functions Descriptions
316
Registry of Motor Vehicles – UMS Programmer’s Manual
314001003 - Make required
314001004 - Year required
314001005 - Entry not valid
314001006 - Enter keys
314001007 - Bad surrogate value
314001008 - Bad surrogate value
314001009 - Odom required
Guest output program
UGR2142P
314001015 - Inquiry complete
Host program
UHR2143P
314001020 - VIN not found
314001021 - DB error
314001022 - Temporary storage not found
314001023 - Temporary storage write error
314001024 - NADA - program not found
314001025 - Link problem
314001026 - Temporary storage delete error
314001027 - Temporary storage item error
314001028 - LR error
314001029 - Temporary storage read error
314001055 - Bad system RC
314001056 - Vehr record not found
314001057 - Vehc record not found
LR
UHR1143L
Map
UGR2140M
Lx Table
UGR2140T
Copy books
UGZCOMMY
UHZCOMMY
UGR214AY
UGR214BY
UIR214CY
UGZ1RFLY
UHUILOGY
(UGR1141P,UGR1142P)
(UHR1143P)
(UGR1141P,UGR1142P)
(UGR1141P)
(UGR1142P,UHR1143P)
(UGR1142P)
(UHR1143P)
Appendix G – Functions Descriptions
317
Registry of Motor Vehicles – UMS Programmer’s Manual
External name
URVN
Internal names
UR10
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Limited secondary session (requires
function change)
F4 - Select from scroll screen (requires
function change)
F5 - Not available
F6 - Screen hopping (requires function
change)
F7 - Not Available
F8 - Not Available
F9 - Not available
F10 - Not available
F11 - Return to primary session
F12 - Not available
Appendix G – Functions Descriptions
318
Registry of Motor Vehicles – UMS Programmer’s Manual
UMA Function
TITLE:
MERIT RATING BOARD - AT FAULT INSURANCE CLAIM
DESCRIPTION:
The UMA function displays detail information about an at-fault
insurance claim and allows the addition of new claims or the
update of existing ones.
COMPONENTS:
Guest input program
UGM0030P
Guest output program
UGM0031P
Host program(s)
UHM0001P
UHM0030P
Map
UGM0030M
LX Table
UGM0030T
Copy books
UHMCTOWN
UHMCLAIM
UMSLXZT
UGZCOMMC
UGM0030C
UHZCOMMC
UHZCOMMY
MMRYNTRT
External name
UMA
Internal name
MRB0
(Person lookup via license, state or name and date
of birth for NOLICENSE/XX)
UMA1
(Retrieve/update at-fault claim information)
Appendix G – Functions Descriptions
319
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen hop using person surrogate
F7 - Not available
F8 - Obtain next subordinate claim
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Add new or update existing claim
NOTE: F6 requires a function change
Appendix G – Functions Descriptions
320
Registry of Motor Vehicles – UMS Programmer’s Manual
UMC Function
TITLE:
MERIT RATING BOARD - COMPREHENSIVE INSURANCE
CLAIM
DESCRIPTION:
The UMC function displays detail information about a
comprehensive insurance claim and allows the addition of new
comprehensive claims or the update of existing ones.
COMPONENTS:
Guest input program
UGM0040P
Guest output program
UGM0041P
Host program(s)
UHM0001P
UHM0040P
Map
UGM0040M
LX Table
UGM0040T
Copy books
UHMCTOWN
UHMCLAIM
UMSLXZT
UGZCOMMC
UGM0040C
UHZCOMMC
UHZCOMMY
External name
UMC
Internal name
MRB0
(Person lookup via license, state or name and date
of birth for NOLICENSE/XX)
UMC1
(Retrieve comprehensive claim information)
Appendix G – Functions Descriptions
321
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen hop using person surrogate
F7 - Not available
F8 - Obtain next subordinate claim
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Add new or update existing comprehensive claim
NOTE: F6 requires a function change
Appendix G – Functions Descriptions
322
Registry of Motor Vehicles – UMS Programmer’s Manual
UMI9 Function
TITLE:
MERIT RATING BOARD - OPERATOR INQUIRY
DESCRIPTION:
The UMI9 function requests Safe Driver Insurance Plan (SDIP)
statement information on one to ten operators per operator inquiry.
COMPONENTS:
Guest programs
UGM0020P
UGM0021P
UGM0029P
Host programs
UHM0001P
UHM0022P
Maps
UGM0020M
UGM0021M
LX Table
UGM0020T
UGM0021T
Copy books
MMRYCTWN
MMRYSDIP
MMRYSDP2
MMRY455D
MMRY455P
UGM0020C
UGM0021C
UGZCOMMC
UHMMINQT
UHZCOMMC
UIR1COMR
UMSLXZT
External name
UMI9 (Accept Operator Inquiry Requests)
Internal name
MRB0 (Person lookup via MMRV-PERS surrogate
number)
UMIQ (Inquiry display)
Appendix G – Functions Descriptions
323
Registry of Motor Vehicles – UMS Programmer’s Manual
UMI3 (Operator incident retrieval)
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Resolve duplicate drivers license (MRBS)
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
324
Registry of Motor Vehicles – UMS Programmer’s Manual
UMO Function
TITLE:
MERIT RATING BOARD - OPERATOR SUMMARY
DESCRIPTION:
The UMO function displays a scrollable list of summary
information about incidents associated with a person or company.
Incidents displayed are citations, at-fault accidents, comprehensive
claims, and insurance inquiries.
A request type option allows the display to be limited to only one
of the above incident types (which will include reversed incidents
and violation detail information for citations), a combination of all
the above types (which will not include reversed incidents), or a
list of only surchargeable incidents.
Additionally, a separate list can be displayed showing all MRB
administrative requests which have been processed for the selected
person.
COMPONENTS:
Guest input program
UGM0010P
Guest output program
UGM0011P
Host program(s)
UHM0001P
UHM0010P
Map
UGM0010M
LX Table
UGM0010T
Copy books
UHMCTOWN
UMSLXZT
UGZCOMMC
UGM0010C
UHZCOMMC
UHZCOMMY
UHM0060C
Appendix G – Functions Descriptions
325
Registry of Motor Vehicles – UMS Programmer’s Manual
External name
UMO
Internal name
MRB0
(Person lookup via license, state or name and date
of birth for NOLICENSE/XX)
UMO1
(Retrieve incident/administrative request
information for person or company)
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
326
Registry of Motor Vehicles – UMS Programmer’s Manual
UMON Function
TITLE:
MERIT RATING BOARD - OPERATOR SUMMARY
DESCRIPTION:
The UMON function displays a scrollable list of summary
information about citation incidents associated with a company.
COMPONENTS:
Guest input program
UGM0070P
Guest output program
UGM0071P
Host program(s)
UHM0001P
UHM0010P
Map
UGM0070M
LX Table
UGM0070T
Copy books
UHMCTOWN
UMSLXZT
UGZCOMMC
UGM0070C
UHZCOMMC
UHZCOMMY
External name
UMON
Internal name
MRB0
(Company lookup via Company Name and/or
vehicle registration.)
UMO1
(Retrieve incident/administrative request
information for company)
Appendix G – Functions Descriptions
327
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
328
Registry of Motor Vehicles – UMS Programmer’s Manual
UMVH Function
TITLE:
MERIT RATING BOARD - TRAFFIC CITATION
DESCRIPTION:
The UMVH function displays history information about a traffic
citation.
COMPONENTS:
Guest input program
UGM0052P
Guest output program
UGM0053P
Host program(s)
UHM0050P
Map
UGM0052M
LX Table
UGM0052T
Copy books
UHMCTOWN
UMSLXZT
UGZCOMMC
UGM0052C
UHZCOMMY
External name
UMVI
Internal name
UMV1
(Retrieve citation information)
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen hop using person/company surrogate
F7 - Not available
F8 - Not available
Appendix G – Functions Descriptions
329
Registry of Motor Vehicles – UMS Programmer’s Manual
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F6 requires a function change
Appendix G – Functions Descriptions
330
Registry of Motor Vehicles – UMS Programmer’s Manual
UMVS Function
TITLE:
MRB DUPLICATE CITATION SCROLL
DESCRIPTION:
The UMVS function displays any duplicate citations in the system.
License number and license state are optional fields that can be
used to restrict the display of duplicate citations to specific
operators.
The UMVS function can only be invoked by another function for
duplicate resolution. The user can then return to the original
function by positioning the cursor at the desired citation
information and pressing F9. Up to five citations are displayed per
page.
COMPONENTS:
Guest input program
UGM0055P
Guest output program
UGM0056P
Host program(s)
UHM0055P
Map
UGM0055M
LX Table
UGM0055T
Copy books
UMSLXZT
UGZCOMMC
UGM0055C
UHZCOMMY
External name
UMVS
Internal name
UMVX
Appendix G – Functions Descriptions
331
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Select from scroll and refresh previous screen
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F4 requires a function change
Appendix G – Functions Descriptions
332
Registry of Motor Vehicles – UMS Programmer’s Manual
UMVI Function
TITLE:
MERIT RATING BOARD - TRAFFIC CITATION
DESCRIPTION:
The UMVI function displays detail information about a traffic
citation.
COMPONENTS:
Guest input program
UGM0050P
Guest output program
UGM0051P
Host program(s)
UHM0050P
Map
UGM0050M
LX Table
UGM0050T
Copy books
UHMCTOWN
UMSLXZT
UGZCOMMC
UGM0050C
UHZCOMMY
External name
UMVI
Internal name
UMV1
(Retrieve citation information)
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - Main menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen hop using person/company surrogate
F7 - Not available
F8 - Not available
Appendix G – Functions Descriptions
333
Registry of Motor Vehicles – UMS Programmer’s Manual
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F6 requires a function change
Appendix G – Functions Descriptions
334
Registry of Motor Vehicles – UMS Programmer’s Manual
UP, UR, UL Function
TITLE:
INSURANCE SUBMENU (UMS SUBMENU SCREEN)
DESCRIPTION:
The UP function is an insurance function of the Uninsured
Motorist System (UMS). The insurance submenu screen displays
seven (7) functions:
UPA
UPH
UPTH
UPIC
UPOI
UVH
UPMV
–
–
–
–
–
–
–
Policy Amend
Policy Holder History Inquiry
Policy Transaction History Inquiry
Policy Information
Policy Operator Inquiry
Vehicle History
Multiple Vehicle Amend
Each of these functions could be invoked by entering an
appropriate function code in the Function field.
The UP function is invoked by entering UP in the FUNCTION
field.
The UR Registration Submenu of the Uninsured Motorist System
(UMS) displays eleven (11) functions:
R1A
RA
RI
RH
RBS
URSN
URSR
URSV
URN
RNF
URVN
-
RMV-1 APPLICATION
REGISTRATION AMEND
REGISTRATION/TITLE INQUIRY
REGISTRATION HISTORY
BANK/LIENHOLDER SCROLL
REGISTRATION SCROLL/NAME
REGISTRATION SCROLL/REG
REGISTRATION SCROLL/VIN
CORPORATE-OWNER DATA SCROLL
CORPORATE-OWNER FID SCROLL
NADA INQUIRY
Each of these functions can be invoked by entering an appropriate
function code in the Function field.
The UR function is invoked by entering UR in the FUNCTION
field.
The UL Licensing Submenu of the Uninsured Motorist System
(UMS) displays seven (7) functions:
Appendix G – Functions Descriptions
335
Registry of Motor Vehicles – UMS Programmer’s Manual
LI
LN
LNO
LNS
ULP
LH
LTH
-
LICENSE NUMBER INQUIRY
LICENSE NUMBER SCROLL
OUT-OF-STATE NUMBER SCROLL
SOCIAL SECURITY NUMBER SCROLL
PERSON-NAME SCROLL
LICENSE HISTORY
LICENSE TRANSACTION HISTORY
Each of these functions can be invoked by entering an appropriate
function code in the Function field.
The UR function is invoked by entering UR in the FUNCTION
field.
COMPONENTS:
Guest Side Menu program
UGZ0010P
103003001 - Submenu in PCTEG absent from module
Copy books
REGEQU
UGZCOMMA
UGZGCTLT
External name
UP, UR, UL
Internal name
UP, UR, UL
AVAILABLE FUNCTION KEYS:
F1 - Main menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Not available
F7 - Not available
F8 - Not available
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
336
Registry of Motor Vehicles – UMS Programmer’s Manual
UPA Function
TITLE:
POLICY AMEND
DESCRIPTION:
The UPA screen is used to inquire, bind, cancel, or reinstate
policies. It will also clear an unpaid premium and amend the
policyholder or the vehicles on an insurance policy. The key data
fields are insurance company code, policy number, policy effective
date, and policy type. The policy type field will either be “C”
(Commercial) or “P” (Private). The screen will display policy and
policyholder information along with all the vehicles, registrations,
and owners currently insured on the policy.
To process a policy inquiry, an action code of “I” is entered with
the policy key data fields. If no action code is entered, it will
default to “I.”
To process a policy cancellation, an action code of “C” is entered
with the policy key data fields. Three types of policy cancellations
exist: cancellation prior to the policy becoming active or bound,
advance cancellation of an active policy (in which the cancellation
effective date is in the future), or immediate cancellation of an
active policy (in which the cancellation effective date is the current
date or sooner). If the cancellation is of an advance policy (policy
not active or bound), the effective date must equal the policy
effective date. If the cancellation is an advance cancel of an active
policy, the effective date must be greater than the current date and
within the policy effective dates. If the cancellation is an
immediate cancel of an active/expired policy, the effective date
must be less than or equal to the current date and within the policy
effective dates. A reason code must be entered to complete the
cancellation. Unpaid premiums are entered when an amount
exists. The F12 key is used to apply updates to the database. After
the cancellation is complete, the policy status and status date will
reflect the cancellation. If an advanced cancellation was
performed, a message stating the policy has been advancecancelled is displayed on the message line.
To process a policy reinstatement, an action code of “R” is entered
with the policy key data fields. The cancellation effective date and
reason code, along with any unpaid premiums, are displayed.
When reinstating cancelled policies, the reinstatement effective
date defaults to the policy’s status date (equal to the cancellation
effective date). When reinstating advance-cancelled policies, the
reinstatement effective date defaults to the cancellation effective
date and may not be changed. A reinstatement reason code must
Appendix G – Functions Descriptions
337
Registry of Motor Vehicles – UMS Programmer’s Manual
be entered to complete the reinstatement. If the reinstatement
reason code entered is 'BOA' (reinstatement Board of Appeals),
then the user must have CAB authority. The reinstatement source
field defaults to the user's ID. Additionally, a reinstatement will
erase the full amount of the unpaid premium. The PF12 key is
used to apply updates to the database. After the reinstatement is
complete, the policy status will return to active and the
cancellation/reinstatement effective dates and reason codes on the
screen are cleared out. Also, for reinstatements of cancelled
policies, the policy status date will reflect the reinstatement
effective date.
To process a policy bind, an action code of “B” is entered with the
policy key data fields. The policy must be in bound status to
process a bind action. The policy number must contain a “#” in the
first digit and be followed by fifteen (15) numeric characters. If
the bound policy is found, a new insurance company policy
number must be entered and it must not contain a “#” in the first
digit. Policy effective date and expire date may also be changed.
The F12 key is used to apply updates to the database.
To process a policy clear unpaid premium, an action code of “U” is
entered with the policy key data fields. The policy must be in
cancelled status and the unpaid premium amount must be greater
than zero to process a clear unpaid premium action. A reason code
must be entered to complete the clear unpaid premium action. The
F12 key is used to apply updates to the database. After the clear
unpaid premium action is complete, the policy unpaid premium
amount will reflect a zero balance.
To process a policy policyholder amend, an action code of “P” is
entered with the policy key data fields. The policy must not be in
cancelled status to process a policyholder amend action. A license
code and license state must be entered to complete the policyholder
amend action. If the license state is MA, the license must be on the
database. If the license is not MA, a new out-of-state license will
only be added if there currently is no policyholder on the policy. If
an out-of-state operator is being added, last name, DOB, mail
address, city, state, and zip must be entered. If the policyholder
has no valid license, “NOLICENSE” must be entered for the
license number and “XX” must be entered for the license state. If
a duplicate license number/state is entered, a screen of duplicate
key choices is displayed to allow the user to select the desired
duplicate. The F12 key is used to apply updates to the database.
After the policyholder amend is complete, the policyholder
information will reflect the new policyholder data.
Appendix G – Functions Descriptions
338
Registry of Motor Vehicles – UMS Programmer’s Manual
Security will only allow insurance companies to update their own
policies. Inquiries may be performed on policies for any company.
The F3 key provides access to a limited secondary session. The
Registration/Title Inquiry screen (URI) will be used in this
secondary session example. After the user has displayed the
information for a policy on the UPA screen, which includes the
VINS and registrations connected with that policy, he/she changes
the function code from UPA to URI, places the cursor on the
desired VIN/Registration detail line and presses F3. This will
transfer him to the URI screen and display the information for the
selected registration. To return to the UPA screen, he/she may
press the Clear key or the F1 key. Once he/she has returned to the
UPA screen, a message is displayed saying that the primary
session has been resumed.
F6 can be used for screen hopping. The user will be able to screen
hop to screens that have a policy or license number as their
primary key. For example the user may F6 to UPTH using the
policy displayed on UPA, or F6 to UPH using the policyholder’s
license displayed on UPA.
When a tape of a new UMS release is sent to the insurance
companies, the companies have 60 days to make changes to the
guest software and maps to make the applications more suitable to
their individual business needs. For this reason, it is necessary to
maintain two versions of the software. During these 60 days, the
UPCR screen, which UPA is replacing, may be accessed by
entering the function code “TPCR,” while the function code
“UPA” will execute the recently modified modules. After the 60day period, TPCR will no longer be available.
COMPONENTS:
Guest input program
UGU3121P
410001001 - PLEASE ENTER KEYS
410001002 - POLICY EFFECTIVE DATE MISSING
410001003 - POLICY # MISSING OR INVALID
410001004 - INS COMPANY # INVALID
410001005 - REASON CODE INVALID
410001006 - ENTRY NOT VALID
410001008 - POLICY # CONTAINS INVALID
CHARACTERS
410001010 - NO SURROGATE FOR F9
410001011 - REQUIRED FIELD MISSING, PLEASE KEY
410001012 - CANCELLATION EFFECTIVE DATE
Appendix G – Functions Descriptions
339
Registry of Motor Vehicles – UMS Programmer’s Manual
INVALID
410001013 - REINSTATEMENT EFFECTIVE DATE
INVALID
410001014 - NO ERRORS - PRESS F12 TO UPDATE
410001024 - NO SURROGATE FOR F4
410001025 - F7/F8 NOT ALLOWED
410001035 - POLICY IN FUTURE CANCEL STATUS
ALREADY
410001038 - MUST HAVE CAB AUTHORITY TO USE
REASON CODE OF BOA
410001058 - CANT F12 AFTER UPDATE COMPLETE
410001060 - MUST CHANGE TO A NEW PLCY HLDR
TO F12
410001101 - UNKNOWN NOWN NOT ALLOWED
410001102 - COMM EFF DATE INVALID
410001107 - 24 VEHC WARNING
410001105 - INV. POLICY TYPE
Guest output program
UGU3122P
410001014 - NO ERRORS - PRESS F12 TO UPDATE
410001038 - MUST HAVE CAB AUTHORITY TO USE
REASON CODE OF BOA
410001060 - MUST CHANGE TO A NEW PLCY HLDR
TO F12
Host programs
UHU3123P
410001015 - LR ERROR
410001016 - IDMS ERROR
410001017 - RECORD MATCHING KEYS NOT FOUND
410001018 - INQUIRY COMPLETE
410001019 - INQUIRY COMPLETE-PLCY CANT BE
CANCELLED
410001020 - INQUIRY COMPLETE-PLCY CANT BE
REINSTATED
410001022 - INQUIRY COMPLETE - PROCEED
WITH CANCEL
410001023 - INQUIRY COMPLETE- PROCEED WITH
REINSTATE
410001026 - BAD PROGRAM CALL
410001027 - INQUIRY COMPLETE - NOT
AUTHORIZED TO PDATE
410001048 - LICENSE NOT FOUND
410001049 - OOS LICENSE NOT FOUND - PROCEED
WITH ADD
Appendix G – Functions Descriptions
340
Registry of Motor Vehicles – UMS Programmer’s Manual
410001050 - OOS LICENSE NOT FOUND - ADD
NOT ALLOWED
410001051 - INQUIRY COMPLETE - UNPAID PREM
CANT BE CLEARED
410001052 - INQUIRY COMPLETE - BIND
REQUEST IS NOT VALID
410001053 - INQUIRY COMPLETE - PLCY CANT
BE AMENDED
410001054 - INQUIRY COMPLETE - BIND ERROR,
PLCY ALREADY EXISTS
410001055 - INQUIRY COMPLETE - PROCEED
WITH CLEAR
410001056 - INQUIRY COMPLETE - PROCEED
WITH BIND
410001057 - INQUIRY COMPLETE - PROCEED
WITH AMEND
410001101 - UNKNOWN NOWN NOT ALLOWED
410001103 - COMPANY NOT FOUND 1
410001104 - COMPANY NOT FOUND 2
431230001 - BAD LINK LOGGING MOD
UHU3124P
410001015 - LR ERROR
410001016 - IDMS ERROR
410001028 - DATA HAS CHANGED SINCE UPDATE
STARTED, RECHECK
410001029 - UPDATE COMPLETE
410001030 - VEHICLE REGISTRATION NOT FOUND
410001031 - UPDATE FAILED
410001032 - POLICY NOT FOUND
410001037 - UPDATE COMPLETE - PLCY HAS
BEEN ADVANCE CANCELLED
410001066 - POLICY EFFECTIVE DATE INVALID
410001067 - POLICY EFFECTIVE DATE > 8000
410001068 - INVALID CANCELLED DATE
410001070 - PREMIUM NOT NUMERIC
410001071 - INVALID CANCELLED REASON
410001072 - REINSTATE DATE NOT EQUAL TO
POLICY DATE
410001073 - REINSTATE EFFECTIVE DATE > 8000
410001074 - INVALID ZIP
410001075 - INVALID REINSTATE REASON
410001076 - UNPAID REASON CODE IS CLEAR
410001077 - PERSON SURROGATE EQUAL ZERO
410001078 - INVALID ADDRESS
410001079 - INVALID NAME
Appendix G – Functions Descriptions
341
Registry of Motor Vehicles – UMS Programmer’s Manual
410001080 - INVALID DATE OF BIRTH
410001081 - INVALID LICENSE
410001082 - INVALID LICENSE STATE
410001083 - INVALID NUMBER OF DETAILS
410001084 - INVALID VEHICLE EFFECTIVE DATE
410001086 - INVALID VEHICLE SURROGATE KEY
410001087 - INVALID TOWN CODE
Map
UGU1120M
Lx table
UGU1120T
Copy books
UGZCOMMY
UHZCOMMY
UIU3112AY
UGU3112BY
UGU3112CY
UGZ1RFLY
UHUILOGY
MSUYTRAN
MREYIORC
(UGU31121P, UGU31122P)
(UHU31123P, UHU31124P)
(UGU31121P, UGU31122P,
UHU31123P, UHU31124P)
(UGU31121P)
(UGU31122P)
(UGU31122P)
(UHU31123P, UHU1124P)
(UHU31124P)
(UHU3123P, UHU3124P)
External name
UPA
Internal names
PA10, PA11, PA12, PA13, PA14
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Limited secondary session (requires function change)
F4 - Screen hopping required function change
F5 - Not available
F6 - Screen hopping (requires function change)
F7 - Not available
F8 - Not available
F9 - Not Available
F10 - Not available
F11 - Not available
F12 - Update
Appendix G – Functions Descriptions
342
Registry of Motor Vehicles – UMS Programmer’s Manual
UPH Function
TITLE:
POLICY HISTORY INQUIRY
DESCRIPTION:
The UPH function is used to display insurance policy information
for a policyholder’s license number or FID number. The user must
enter the license number to use this screen. The state code must
also be entered for out-of-state licenses. If more than one person
has the same license number/state, the user is transferred to one of
two license number scroll screens to resolve the duplicate license
number. For Massachusetts duplicate license numbers, the user is
transferred to the License Number Scroll (LN) screen. Out-of-state
license duplicates are resolved on the Out-Of-State License
Number Scroll (LNO) screen.
The F3 key provides access to the UPA and UPTH screens. The
UPA (Policy Amend) screen will be used in this secondary session
example. After the user has displayed the policy history for a
person using the UPH screen, the user places the cursor on the
desired policy detail line, changes the function code from UPH to
UPA and presses F3. This will transfer the user to the UPA screen
and display the information for the desired policy. At this time, the
user is in inquiry mode, but may change the action code and press
the Enter key to change the mode to update. When the user is
finished inquiring or updating a policy, he/she may press the Clear
key or the F1 key to return to where he/she was on the UPH
screen, thus resuming the primary session.
The F11 key is used for rescrolling. When the user has been
transferred to the UPH screen because he/she pressed the F4 or F9
key on a scroll screen, the user may decide he/she has selected the
wrong person. The user may return to the scroll screen, in order to
make a new selection, by changing the function code to the
appropriate scroll screen’s function and pressing the F11 key.
When a tape of a new UMS release is sent to the insurance
companies, the companies have 60 days to make changes to the
guest software and maps to make the applications more suitable to
their individual business needs. For this reason, it is necessary to
maintain two versions of the software. During these 60 days, the
old version of UPH may be accessed by entering the function code
“TPH,” while the function code “UPH” will execute the recently
modified modules. After the 60-day period, TPH will no longer be
available.
Appendix G – Functions Descriptions
343
Registry of Motor Vehicles – UMS Programmer’s Manual
NOTE: A typical use of the UPH screen would be to find the
insurance policy information for policyholders using their license
number/state.
COMPONENTS:
Guest input program
UGU3041P
411001016 - F7 is not valid
411001015 - No surrogate found for F4
411001012 - Entry not valid
411001011 - Required field missing - Please key
411001014 - End of set - No more records
411001013 - F8 for more records
Guest output program
UGU3042P
411001006 - No policy records for this person
411001001 - F8 for more records
411001002 - No more records
Host program
UHU3043P
411001003 - A record matching entered key(s) was not
found
411001006 - No policy records for this person
411001004 - LR error
411001007 - Bad program link
411001008 - Database error
412043001 - Response not normal
412043002 - Response not normal
Map
UGU3040M
Lx table
UGU3040T
Copy books
UGZCOMMY
UHZCOMMY
UGU304IY
UGU3UPHY
UIU304OY
UGZ2RFLY
UHUILOGY
UHU3DIPY
(UGU2041P,UGU2042P)
(UHU2043P)
(UGU2041P,UGU2042P)
(UGU2041P)
(UGU2042P,UHU2043P)
(UGU2042P)
(UHU2043P)
(UHU2043P)
Appendix G – Functions Descriptions
344
Registry of Motor Vehicles – UMS Programmer’s Manual
External name
UPH
Internal names
UU22, UU23, UU24
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Limited secondary session
F4 - Select from scroll screen
F5 - Not available
F6 - Screen hopping
F7 - Page backward
F8 - Page forward
F9 - Resolve duplicates from License Scroll screens
F10 - Not available
F11 - Rescroll
F12 - Not available
NOTE: F3, F4, and F6 requires function change
Appendix G – Functions Descriptions
345
Registry of Motor Vehicles – UMS Programmer’s Manual
UPIC Function
TITLE:
POLICY INFORMATION CHANGE OF CARRIER REQUEST
DESCRIPTION:
UPIC is used to process policy change of carriers. This function
allows the user to enter a new policy with up to 24 vehicles. The
user is only allowed access to UPIC after successful inquiry of the
operator has been done on the UPOI screen. The policy
information, name, and address information from the UPOI screen
carries over to the UPIC screen for further processing. The UPIC
screen has eight pages, with each page holding up to three
vehicles.
The program checks each vehicle entered for a duplicate
registration or VIN on the database. If a duplicate exists, the user
is transferred to the appropriate scroll screen to resolve the
duplicate condition.
NOTE: A typical use of the UPIC function would be to change the
insurance carrier when only the operator’s license number is
known.
COMPONENTS:
Guest input program
UGU4021P
413001004 - F8 for more or F12 to update
413001005 - Record not found
413001009 - F7 to page backward or F12 to update
413001008 - Duplicates exist - press enter to resolve
413001010 - No REG found for vehicle
413001006 - LR error
413001002 - Update complete
413001022 - F12 to update
413001012 - Policy number invalid
413001013 - Required field missing
413001014 - F7/backward or F8/forward
413001015 - Please enter required keys
413001016 - No more vehicles to display
413001017 - Duplicate REG entered
413001018 - Enter all vehicle info before F8
413001019 - Invalid characters keyed
413001020 - Duplicate VIN entered
413001021 - Entry not valid
413001025 - Need at least one vehicle for F12
413001027 - Enter VIN or reg for town code
413001028 - New town code entered, F8 or F12 to update
Appendix G – Functions Descriptions
346
Registry of Motor Vehicles – UMS Programmer’s Manual
413001029
413001026
413001045
413001046
413001051
413001055
413001056
413001057
- New town code entered, F7 or F12 to update
- New town code entered, press F12 to update
- Corporate name required
- Address required
- Last vehicle
- Bad DOB
- Bad DOB convert date
- Bad current convert date
Guest output program
UGU4022P
413001018 - Enter all vehicle info before F8
413001016 - No more vehicles
413001014 - F7 or F8
413001028 - New town code entered, F8 or F12 to update
413001129 - New town code entered, F7 or F12
413001004 - F8 or F12 to update
413001009 - F7 or F12 to update
413001008 - Resolve duplicates
413001005 - Not found
413001010 - REG not found
413001006 - LR error
413001002 - Update complete
413001022 - F12 to update
413001026 - New town code entered, press F12 to update
413001015 - Enter required keys
413001017 - Duplicate REG
413001020 - Duplicate VIN
Host program(s)
UHU4023P
413001011 - Policy number already on file
413001006 - LR error
413001007 - DML error
413001016 - No more vehicles
UHU4024P
UHU4024L00001102 - Record obtained
UHU4024L00001202 - Other actions
UHU4024L03261101 - Record not found
UHU4024L00009010 - Modified record OK
UHU4024L00001001 - OFNS-NCSH record stored
UHU4024L03261301 - VEHR not found
UHU4024L00001401 - SLR-NCSH record stored
Appendix G – Functions Descriptions
347
Registry of Motor Vehicles – UMS Programmer’s Manual
UHU4025P
413001008 - Resolve duplicates
413001005 - Record not found
413001010 - No registration
413001006 - LR error
413001002 - Update successful
413001016 - No more VEHC
413001017 - Duplicate registration
413001020 - Duplicate VIN
Map
UGU1020M
Copy books
UGZCOMMY
UIU3010Y
UIU4120Y
UGU4PICY
UIU3020Y
UHUILOGY
UHRREGSY
UILXCNST
MREYIOWK
MUMYVEHC
(ALL)
(UGU1021P)
(ALL)
(UGU1021P)
(UGU1022P)
(UHU1023P)
(UHU1023P)
(UHU4025P)
(UHU4025P)
(UHU4025P)
External name
UPIC
Internal name
UU21, UU20
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Not available
F7 - Scroll to the first page
F8 - Scroll to the second page
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Update
Appendix G – Functions Descriptions
348
Registry of Motor Vehicles – UMS Programmer’s Manual
UPMV Function
TITLE:
MULTIPLE VEHICLE AMEND
DESCRIPTION:
The UPMV screen is used to inquire on, add, or delete the vehicles
associated with an insurance policy. The required key data fields
are policy type, insurance company code, policy number, and
policy effective date. The screen will display policy information,
policyholder name, and all the vehicles, registrations, and owners
currently insured on the policy. Optional key data fields are plate
type and registration number. When these are keyed, the screen
will display vehicles starting with the keyed registration.
To process a policy vehicle inquiry, an action code of “I” is
entered with the required and optional key data fields.
To process a policy vehicle add, an action code of “A” is entered
with the required key data fields. The optional key data fields are
not allowed on an add. The 12 vehicle detail lines will be cleared
and the new vehicles may be added. The keys that may be entered
are VIN or plate type, registration, and plate color. The keys
entered on each detail line must be unique and must exist on the
database. If there are duplicate records on the database for the
VIN or registration entered, a screen of duplicate key choices is
displayed to allow the user to select the desired duplicate. The
vehicle effective date is a required field, while the premium town
code is optional. The vehicle effective date must be within the
policy effective dates. When updates are applied to the database
for an added vehicle, this date will become the vehicle’s beginning
coverage date. If a premium town code is entered and it is
different from the registration’s town code, an informational
message is displayed. The F12 key is used to apply the updates to
the database. Twelve vehicles may be added at one time. Once
these vehicles have been added to the database, pressing F8 or
Enter will clear the vehicle detail lines and allow 12 more vehicles
to be added.
To process a policy vehicle delete, an action code of “D” is entered
with the required and optional key data fields. The vehicle
effective date initially displayed, (i.e. the vehicle’s beginning
coverage date), is cleared and the user must enter the effective date
of the delete. The entered vehicle effective date must be within the
policy effective dates and not less than the vehicle’s beginning
coverage date. When updates are applied to the database for a
deleted vehicle, this date will become the vehicle’s ending
Appendix G – Functions Descriptions
349
Registry of Motor Vehicles – UMS Programmer’s Manual
coverage date. The F12 key is used to apply the updates to the
database. Once the database updates are complete, the updated
vehicle information will automatically be displayed.
Security will only allow insurance companies to update their own
policies. However, inquires may be performed on policies for any
company.
The F3 key provides access to a limited secondary session. The
Registration/Title Inquiry screen (URI) will be used in this
secondary session example. After the user has displayed the
information for a policy on the UPMV screen, which includes the
VINs and registrations connected with that policy, they change the
function code from UPMV to URI, place the cursor on the desired
VIN/Registration detail line, and press F3. This will transfer them
to the URI screen and display the information for the selected
registration. To return to the UPMV screen, the user may press the
Clear or F1 key. After being returned to the UPMV screen, a
message is displayed saying that the primary session has been
resumed.
The F6 key can be used for screen hopping. The user will be able
to screen hop to screens that have a policy, license, or FID number
as their primary key. For example, the user may F6 to UPTH
using the policy displayed on UPMV or F6 to UPH using the
policyholder’s license or FID number.
The F7 and F8 keys can be used for paging backward and forward
if the policy covers more than 12 vehicles.
The F9 key can be used as a quick way to jump to the UPA screen.
If a policy has been displayed and the user presses the F9 key
while the cursor is located anywhere on the first 12 lines of the
screen, the user will be screen hopped to UPA. It is important to
note that if the user is on a screen that allows limited secondary
sessions (F3 key) and they transfer to UPA and then use the “V”
action code to transfer to UPMV, they must use F9 to return to
UPA. If the Clear or F1 key is pressed, they will bypass the UPA
screen and be returned to the primary session. The F9 key may
also be used to resolve duplicates from Registration and VIN scroll
screens.
The F12 key will perform database updates.
Appendix G – Functions Descriptions
350
Registry of Motor Vehicles – UMS Programmer’s Manual
COMPONENTS:
Guest input program
UGU1141P
300310003 - Screen hop error
411141001 - Invalid program entry
411141002 - Enter vehc
411141003 - Invalid VIN
411141004 - VEHC key required
411141005 - Invalid effective date
411141006 - Nonunique reg
411141007 - Nonunique VIN
411141008 - F12-Message
411141009 - No vehicles
411141010 - Required field missing
411141011 - Less bcov date
411141012 - No deletes
411141013 - F7 not allowed
411141014 - First page
411141015 - Last page
411141016 - F12 after update
411141017 - F9 surrogate error
411141018 - Town F12 message
411141019 - Invalid F4 surrogate
411141020 - Enter keys
411141021 - No reg add on
411141022 - Invalid insurance number
411141023 - Invalid character
411141024 - Policy missing
411141025 - Effective date missing
411141026 - Maximum pages
411141027 - Delete message
411141028 - No amends
411141029 - Empty page
411141030 - Action missing
411141031 - Policy type missing
Guest output program
UGU1142P
Host programs
UHU1143P, UHU1144P
Map
UGU1140M
LxTable
UGU1140T
Appendix G – Functions Descriptions
351
Registry of Motor Vehicles – UMS Programmer’s Manual
Copy books
UGZCOMMY
UHZCOMMY
UIU114AY
UIU114BY
UIU114CY
UGZ2RFLY
UILXCNST
UHUILOGY
MREYIOWK
MREYEDIT
MSUYTRAN
(UGU1141P, UGU1142P)
(UHU1143P)
(UGU1141P)
(UGU1141P, UGU1142P, UHU1143P)
(UHU1143P, UHU1144P)
(UGU1142P)
(UGU1141P,UGU1142P, UHU1143P)
(UHU1143P, UHU1144P)
(UHU1143P)
(UHU1143P)
(UHU1144P)
External name
UPMV
Internal name
PA09
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Limited secondary session
F4 - Not available
F5 - Not available
F6 - Screen Hopping
F7 - Scroll backward
F8 - Scroll forward
F9 - Screen hop to UPA
Resolves duplicates from
Registration and VIN scroll screens
F10 - Not available
F11 - Not available
F12 - Update
Appendix G – Functions Descriptions
352
Registry of Motor Vehicles – UMS Programmer’s Manual
UPOI Function
TITLE:
POLICY OPERATOR INQUIRY
DESCRIPTION:
The UPOI screen is used to request operator information by
operator license or FID number and policy effective date. The
required fields are insurance company code, vehicle number,
effective date, and operator license or FID number.
If the policy number is entered, then the coverage code and market
indicator are required. If the license state is not entered, the default
is ‘MA.’ If more than one operator is entered, then at least one of
the operators must be marked as the policy holder.
The user has the option to start a second session by changing the
function code and pressing F3. The information on the screen is
carried over to the requested screen. If F3 is pressed again, the
user is returned back to the UPOI screen. By using the secondary
session, the user can be doing two functions at once.
When a tape of a new UMS release is sent to the insurance
companies, the companies are given 60 days to make changes to
the guest software and maps to make the applications more suitable
to their individual business needs. For this reason, it is necessary
to maintain two versions of the software. During those 60 days,
the old, unchanged version of UPOI may be accessed by entering
function code “TPOI,” while function code “UPOI” will execute
the recently modified modules. After the 60-day period, TPOI will
no longer be available.
Note: A typical use of this screen would be to inquire on the
operators that are going to be added to a new policy.
COMPONENTS:
Guest input program
UGU3011P
412001001 - BAD CALL TO DATE CONVERTER
412001002 - NO SURROGATE FOR F9
412001004 - PLEASE ENTER REQUIRED KEYS
412001008 - POLICY NUMBER CONTAINS INVALID
CHARACTERS
412001009 - KEY PRESSED IS INVALID
412001010 - DUP LICENSE NUMBER KEYED
412001011 - EXPIRE DATE INVALID
412001012 - EFFECTIVE DATE INVALID
412001013 - REQUIRED FIELD MISSING, PLEASE
Appendix G – Functions Descriptions
353
Registry of Motor Vehicles – UMS Programmer’s Manual
ENTER
412001014 - AT LEAST ONE OPERATOR IS
REQUIRED
412001015 - POLICY HOLDER MUST BE
INDICATED
412001027 - F9 DUP ONLY
412001028 - INSURANCE COMPANY NUMBER
INVALID, PLEASE RE-ENTER
412001029 - VEHICLE NUMBER INVALID, PLEASE
RE-ENTER
412001003 - ENTRY NOT VALID
412001039 - ONLY ONE PH
412001042 - COMM POLICY EFF DATE INVALID
Guest output program
UGU3012P
412001018 - INQUIRY PROCESS COMPLETE
412001016 - A RECORD MATCHING ENTERED
KEY(S) WAS NOT FOUND
412001025 - DUPLICATES EXIST PRESS ENTER
TO RESOLVE
412001026 - DUP LICENSE NUMBER KEYED,
PLEASE CORRECT
412001030 - OUT OF STATE LIC # NOT FOUND
PROCEED WITH UPDATE
412001031 - MASS/LIQUOR ID FOUND - PROCEED
WITH UPDATE
412001033 - OUT OF STATE LIC # DUPLICATES
FOUND
2001040 - DUPLICATE FID FOUND
2001041 - FID NOT FOUND
Host program(s)
UHU3013P
412001016 - A record matching entered keys was not
found
412001017 - Database error
412001032 - Signon not authorized for ins co inquiry
412001041 - Record not found
412001042 - Database error
412001050 - Invalid character entered
412001051 - Exp date invalid
412001052 - Eff date invalid
412001053 - Eff date missing
412001054 - License FID required
412001055 - Phone number required
Appendix G – Functions Descriptions
354
Registry of Motor Vehicles – UMS Programmer’s Manual
412001056 - Insurance number invalid
412001057 - Only one phone
412001058 - Commercial policy effective date invalid
412001059 - Missing policy type value
412001060 - Invalid state for license
412001061 - Enter expiration date
412001062 - May not use reserved FID
412001063 - Bad effective date conversion (gregorian)
412001064 - Bad current date conversion
412001065 - Bad effective date conversion (julian)
412001066 - Bad comparison date conversion
UHU3014P
412001001 - Bad date conversion
412001005 - Database error
412001032 - Signon not authorized for ins co inquiry
412001037 - Years expired invalid
430140001 - Bad link service module 1
430140002 - Bad link service module 3
430140003 - Bad link logging module
Map
UGU2010M
Copy books
UGZCOMMY
UHUILOGY
UHZSTATC
MREYIOWK
UIU3010Y
UGZ2RFLY
MREYIOMW
UGU3POIY
MREYIORC
UHU3DIPY
(ALL)
(UHU3014P)
(UHU3014P)
(UGU3012P)
(ALL)
(UGU3012P)
(UGU3012P)
(UGU3011P)
(UHU3014P)
(UHU3014P)
External name
UPOI
Internal name
UU25
Appendix G – Functions Descriptions
355
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Limited secondary session (requires function change)
F4 - Not available
F5 - Not available
F6 - Not available
F7 - Not available
F8 - Not available
F9 - Duplicate resolution from license or FID scroll screens
F10 - Not available
F11 - Not available
F12 - Not available
Appendix G – Functions Descriptions
356
Registry of Motor Vehicles – UMS Programmer’s Manual
UPTH Function
TITLE:
POLICY TRANSACTION HISTORY INQUIRY
DESCRIPTION:
The UPTH function is used to display policy history information
for a policy. To use this screen, the insurance company number,
policy number, and policy effective date must be entered. Also, a
“C” (Commercial) or “P” (Private) needs to be added to the POL
TYPE field.
The detail lines on this screen represent each policy history entry
recorded for a policy and will be in ascending transaction date
order. Multiple pages may be displayed by using the standard F7
and F8 for page backward and forward.
This screen can “hop” to UPA, UPMV, or UPH by changing the
function code to the desired screen and pressing the F6 key.
When a tape of a new UMS release is sent to insurance companies,
they have 60 days to make changes to the guest software and maps
to make the applications more suitable to their individual business
needs. For this reason, it is necessary to maintain two versions of
the software. During these 60 days, the old version of UPTH may
be accessed by entering the function code “TPTH,” while the
function code “UPTH” will execute the recently modified
modules. After the 60-day period, TPTH will no longer be
available.
NOTE: A typical use of the UPTH screen would be to find
detailed policy history information related to a particular policy.
COMPONENTS:
Guest input program
UGU2131P
415001001 - Entry not valid
415001002 - Enter required fields
415001003 - Policy number contains invalid
characters
415001004 - Policy number missing or
invalid
415001005 - Insurance company number
invalid
415001006 - Policy effective date missing
415001007 - F7 is not valid
415001008 - No surrogate for F4
415001009 - End of set - no more records
Appendix G – Functions Descriptions
357
Registry of Motor Vehicles – UMS Programmer’s Manual
415001010 - Policy type missing
Guest output program
UGU2132P
415001009 - No more records
415001015 - F8 For more records
Host program(s)
UHU2133P
421330001 - Bad link
415001020 - LR error - work-plcy-request
invalid
415001021 - A record matching entered keys
was not found
415001022 - LR error
415001023 - No history records found for
policy
415001024 - LR error using dbkey
Lr
UHU1133L
Map
UGU1130M
Lx table
UGU1130T
Copy books
UGZCOMMY
UHZCOMMY
UGU213AY
UGU213BY
UIU213CY
UHUILOGY
MREYIORC
(UGU2131P,UGU2132P)
(UHU2133P)
(UGU2131P,UGU2132P)
(UGU2131P)
(UGU2132P,UHU2133P)
(UHU2133P)
(UHU2133P)
External name
UPTH
Internal name
UU26
Appendix G – Functions Descriptions
358
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Not available
F5 - Not available
F6 - Screen hopping
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not available
F12 - Not available
NOTE: F6 requires function change
Appendix G – Functions Descriptions
359
Registry of Motor Vehicles – UMS Programmer’s Manual
URN Function
TITLE:
NON-INDIVIDUAL (COMPANY/CORPORATE) NAME
INQUIRY
DESCRIPTION:
The URN function is used to request license or registration
information by company/corporation name. The key fields are
company name, active plates indicator, exact company name match
indicator, and company only indicator. Only the company name is
required, and this entry may be as short as one character (for
example, locate all companies whose names begin with a particular
letter). The active plates indicator, exact company name match
indicator, and company only indicator are Y (yes) or N (no) fields,
with a system default of N. In order to activate these fields, the
operator must type over the N on the screen with a Y.
If the active plates indicator is entered as a Y, only active plate
numbers are displayed for the requested company name; otherwise,
all plate numbers for the requested company are selected (active,
expired, revoked).
If the exact company name match indicator is entered as a Y, all
characters entered in the company name field are used as a search
argument; otherwise, only the first twenty characters are used.
If the company only indicator is entered as a Y, only the company
name and address displays on the screen; registration information
is suppressed.
COMPONENTS:
Guest input program
UGR0010P
203001001 - Please enter CORP/CO name
203001002 - No records for this key on database
203001003 - Enter Y or N for active plate
203001004 - Enter Y or N on exact CORP/CO match
203001005 - Enter Y or N for CORP/CO only
203001007 - F8 Invalid - inquiry must be done first
203001008 - F7 Invalid - no prev screen encountered
203001010 - F8 Invalid - improper cursor positioning
203001011 - F8 Invalid - end of set encountered
Guest output program
UGR0011P
203001006 - End of set encountered
203001012 - Enter F8 to begin scroll
Appendix G – Functions Descriptions
360
Registry of Motor Vehicles – UMS Programmer’s Manual
203001013 - Enter F8 to continue to scroll forward
203001014 - Maximum number of reads press F8 to continue
Host program(s)
UHR0010P
203001002 - No records for this key on database
Map
UGR0010M
Copy books
UGZCOMMC
DFHATTRB
DFHAID
UHZCOMMC
IDMS LR UHR0010L-LR
IDMS SUBSCHEMA BINDS
(UGR0010P, UGR0011P)
(UGR0010P)
(UGR0010P)
(UHR0010P)
(UHR0010P)
(UHR0010P)
External name
URN
Internal name
RN01
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Rescroll
F12 - Not available
NOTE: F4 requires function change
Appendix G – Functions Descriptions
361
Registry of Motor Vehicles – UMS Programmer’s Manual
URSN Function
TITLE:
Registration/VIN Scroll/Name
DESCRIPTION:
The URSN function is used to request and display a list of vehicle
registrations or vehicle VINs by name. The key fields (fields to be
entered) are last name, first name, middle name, date of birth, or
registration status. The last name is the only required field, and
this entry may be as short as one character. The first name, middle
name, date of birth, and registration status are optional but may be
used to narrow the search. In addition to the key fields, the VIN
display field determines whether vehicle registration or VIN
information will be displayed.
Note: A typical use of this screen would be to find the registration
of an individual when only a name or part of a name is available.
COMPONENTS:
Guest input program
UGR1091P
Guest output program
UGR1092P
Host program
UHR1093P
Map
UGR1090M
Copy books
UGZCOMMY
UGR1090Y
UHUILOGY
UIR1090Y
UIR1RSNY
(ALL)
(UGR1091P, UGR1092P)
(UHR1093P)
(UGR1092P, UHR1093P)
(UGR1091P)
External name
URSN, TRSN
Internal name
UR07
Appendix G – Functions Descriptions
362
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Select from scroll screen (requires function change)
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Select from scroll screen (requires function change)
F10 - Not available
F11 - Rescroll
F12 - Not available
Appendix G – Functions Descriptions
363
Registry of Motor Vehicles – UMS Programmer’s Manual
URSR Function
TITLE:
REGISTRATION SCROLL/REGISTRATION
DESCRIPTION:
The URSR function is used to request and display a list of vehicle
registrations by registration number. The key fields (fields to be
entered) are plate type, registration number, plate color, and
registration status. The registration number is the only required
field. This entry may be as short as 1 character (for example, to
display all registrations whose registration number begin with the
number 4). The plate type, plate color, and registration status are
optional but may be used to narrow the search.
NOTE: A typical use of this screen would be to find the
registration of an individual if all or part of the registration number
is known.
COMPONENTS:
Guest input program
UGRI1241P
Guest output program
UGR1242P
Host program
UHR1243P
Map
UGR1240M
Copy books
UGZCOMMY
UGRIRSRY
UHUILOGY
UIR1240Y
UHRREGSY
(ALL)
(UGR1241P)
(UHR1243P)
(UHR1243P, UGR1241P, UGR1242P)
(UHR1243P)
External name
URSR
Internal name
UR02
Appendix G – Functions Descriptions
364
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page forward
F8 - Page backward
F9 - Select from scroll screen
F10 - Not available
F11 - Rescroll
F12 - Not available
NOTE: F4 and F9 require a function change
Appendix G – Functions Descriptions
365
Registry of Motor Vehicles – UMS Programmer’s Manual
URSV Function
TITLE:
REGISTRATION SCROLL/VEHICLE IDENTIFICATION
NUMBER (VIN)
DESCRIPTION:
The URSV function is used to request and display a list of vehicle
registrations by VIN. The key fields (fields to be entered) are VIN
and registration status. The VIN is the only required field, and this
entry may be as short as one character. The registration status is
optional but may be used to narrow the search.
NOTE: A typical use of this screen would be to find the
registration of an individual if all or part of the VIN is known.
COMPONENTS:
Guest input program
UGRI101P
310001001 - End of set encountered
310001002 - Beginning of set encountered
310001003 - Status keyed is invalid
310001004 - Entry not valid
310001005 - Please enter keys
310001006 - VIN missing - please enter
310001007 - Enter key valid with key changes only
Guest output program
UGRO101P
310001008 - F8 for more records
310001009 - End of set encountered, no more records
310001015 - Duplicate encountered
Host program
UHRI101P
310001010 - Logical record error
310001011 - IDMS error
310001012 - A record matching entered key was not found
310001017 - Response not normal
Map
UGR101UM
Copy books
UGZCOMMY
UHRO101Y
UGUIPOIY
UIRO101Y
(ALL)
(UHRI101P)
(UHRI101P)
(UGRO101P)
Appendix G – Functions Descriptions
366
Registry of Motor Vehicles – UMS Programmer’s Manual
UIRI101Y
UHUILOGY
(UGRI101P, UGRO101P)
(UHRI101P)
External name
URSV
Internal name
UR03
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Select from scroll screen
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Select from scroll screen
F10 - Not available
F11 - Rescroll
F12 - Not available
NOTE: F4 and F9 require a function change
Appendix G – Functions Descriptions
367
Registry of Motor Vehicles – UMS Programmer’s Manual
UVH Function
TITLE:
VEHICLE POLICY HISTORY INQUIRY
DESCRIPTION:
The UVH function is used to display policy information related to
a registration or vehicle identification number (VIN). The user
must enter either the registration information (plate type,
registration number, and color) or the VIN to use this screen. If a
duplicate registration key is entered, the user will be transferred to
URSR and prompted to cursor select the correct registration
number. If a duplicate VIN is entered, URSV will execute, and the
user will be prompted to cursor select the correct VIN.
The detail lines on this screen represent each policy that the keyed
vehicle/registration was covered by and when it was covered. The
detail lines are sorted in descending order by policy begin coverage
date. Multiple pages may be displayed on this screen by using the
standard F7 and F8 for page forward and back.
This screen can be “hopped” to/from URI using F6 or from
URSR/URSV/URSN with an F4 cursor select. In addition, the F3
key provides access to a limited secondary session. Secondary
session is invoked by taking the following steps. After displaying
the policies for a registration or VIN using the UVH screen,
change the function code from UVH to UPA, cursor select the
desired policy detail line, and press F3. This will transfer the user
to the UPA screen and display the information for the desired
policy. At this time, the user is in inquiry mode, but may change
the action code and press the Enter key to change the mode to
update. To return to the UVH screen, press the Clear key or the F1
key and resume the primary session.
The F11 key is used for rescrolling. When the user has been
transferred to the UVH screen by pressing the F4 or F9 key on a
scroll screen, the user may return to the scroll screen in order to
make a new selection. This is done by changing the function code
to the appropriate scroll screen’s function and pressing the F11
key.
When a tape of a new UMS release is sent to insurance companies,
they have 60 days to make changes to the guest software and maps
to make the applications more suitable to their individual business
needs. For this reason, it is necessary to maintain two versions of
the software. During these 60 days, the old version of UVH may
be accessed by entering the function code “TVH,” while the
Appendix G – Functions Descriptions
368
Registry of Motor Vehicles – UMS Programmer’s Manual
function code “UVH” will execute the recently modified modules.
After the 60-day period, TVH will no longer be available.
NOTE: A typical use of the UVH screen would be to find policy
information related to a registration or VIN.
COMPONENTS:
Guest input program
UGU3111P
414001001 - Plate type or VIN equal spaces
414001002 - No surrogate found - F4
414001003 - F7 not valid
414001004 - No more records
414001005 - Entry not valid
414001025 - Reference not number
Guest output program
UGU3112P
414001009 - F8 for more
414001004 - No more records
414001013 - Policy not found
Host program
UHU3113P
414001011 - Registration not found
414001012 - VIN not found
414001014 - LR error
414001015 - More than 120 policies
414001016 - Paging error
414001020 - Lookaside invalid function
414001021 - Lookaside surrogate invalid
414001022 - Lookaside length error
414001027 - LR error
414001028 - LR error
414001029 - LR error
414001030 - LR error
414001031 - LR error
414001032 - No section 1032
414001033 - No registration
414001034 - 1 policy not found
431130001 - Bad link on lookaside
431130002 - Bad link logging mod
LR
UHU2113L
Appendix G – Functions Descriptions
369
Registry of Motor Vehicles – UMS Programmer’s Manual
Map
UGU3110M
Lx table
UGU3110T
Copy books
UGZCOMMY
UHZCOMMY
UGU111AY
UGU111BY
UIU111CY
UGZ1RFLY
UHUILOGY
(UGU1111P,UGU1112P)
(UHU1113P)
(UGU1111P,UGU1112P)
(UGU1111P)
(UGU1112P,UHU1113P)
(UGU1112P)
(UHU1113P)
External name
UVH
Internal names
VH07, VH08
AVAILABLE FUNCTION KEYS:
F1
F2
F3
F4
F5
F6
F7
F8
F9
- End session
- UMS Menu
- Limited secondary session
- Select from scroll screen
- Not available
- Screen hopping
- Page backward
- Page forward
- Resolve duplicates from Registration
or Vehicle scroll screens
F10 - Not available
F11 - Rescroll
F12 - Not available
NOTE: F3, F4, and F6 require function change
Appendix G – Functions Descriptions
370
Registry of Motor Vehicles – UMS Programmer’s Manual
VT Function
TITLE:
VEHICLE TITLE HISTORY
DESCRIPTION:
The VT function is used to request and display current and
historical title and registration information by the Vehicle
Identification Number (VIN). The key field (field to be entered) is
the VIN, which is the only required field.
NOTE: A typical use of this screen would be to find the current
and historical titles and registrations attached to a vehicle.
Multiple pages may be displayed on this screen by using the
standard F7 and F8 for page forward and back.
This screen can be transferred from a UMS screen (eg. RH, T1A)
or an ALARS screen (eg. TH, RVV) if a vehicle key is passed.
The screen can transfer to another screen using either the vehicle,
title, or registration information. Pressing F6 transfers to another
screen with the vehicle information. Positioning the cursor to a
detail line and pressing F4 transfers to another screen with either
the title or registration.
This screen resolves duplicate VIN numbers by transferring to the
URSV screen which will display the duplicate VINs, owners,
registrations, and the current status. By positioning the cursor on a
detail line and pressing F9, URSV will transfer back to the VT
screen and display the current and historical vehicle information
for the entry selected.
COMPONENTS:
Guest input program
UGR3261P
327001001 - Entry not valid
327001002 - Enter keys
327001003 - No surrogate F4
327001004 - Beginning of set encountered
327001005 - End of set
327001006 - Leading spaces
Guest output program
UGR3262P
327002001 - F8 for more
327002002 - No more records
Appendix G – Functions Descriptions
371
Registry of Motor Vehicles – UMS Programmer’s Manual
Host program
UHR3263P
327003001 - VIN not found
327003002 - No records for key
327003003 - No more data
327003004 - LR error
327003005 - Bind error
327003006 - Finish error
327003007 - Vehicle information
327003008 - DML error
Map
UGR3260M
Copy books
UGZCOMMY
UHZCOMMY
UGR326AY
UGR326BY
UIR326CY
UHUILOGY
MREYBNME
MREYBADR
MREYBADW
MREYBNMW
MREYBADP
MREYBNMP
(UGR3261P, UGR3262P)
(UHR3263P)
(UGR3261P, UGR3262P)
(UGR3261P)
(UGR3262P, UHR3263P)
(UHR3263P)
(UHR3263P)
(UHR3263P)
(UHR3263P)
(UHR3263P)
(UHR3268P)
(UHR3268P)
External name
VT
Internal name
VT03
Appendix G – Functions Descriptions
372
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End session
F2 - UMS Menu
F3 - Not available
F4 - Screen transfer using cursor select
F5 - Not available
F6 - Screen transfer using keyed vehicle
F7 - Page forward
F8 - Page backward
F9 - Not available
F10 - Not available
F11 - Rescroll
F12 - Not available
Appendix G – Functions Descriptions
373
Registry of Motor Vehicles – UMS Programmer’s Manual
ULP Function
TITLE:
UMS PERSON NAME SCROLL
DESCRIPTION:
The ULP function is used to request license or registration
information by name. The key fields (fields to be entered) are last
name, first name, middle name, and date of birth. Only the last
name field is required, and this entry may be as short as one
character (for example, locate all license holders whose last names
begin with a particular letter). The first name, middle name, and
date of birth entries are optional and used to narrow the search (for
example, when locating John Q. Public born 10/30/41, the program
returns only one entry).
COMPONENTS:
Guest input program
UGL0030P
201001001 - Invalid last name, please reenter
201001002 - Invalid first name, please reenter
201001003 - Invalid middle name, please reenter
201001004 - Invalid date of birth, please reenter
201001005 - Beginning of set encountered
201001006 - End of set encountered
201001007 - Enter name and date of birth,
press enter to begin
201001008 - F7 Invalid - Inquiry must be done first
201001009 - F8 Invalid - Inquiry must be done first
201001010 - Last name is required
Guest output program
UGL0031P
201001006 - End of set encountered
201001011 - More records on database - use F8
201001012 - More records on database - use F8
201001013 - Maximum number of reads press F8 to continue
Host program(s)
UHL0040P
Map
UGL0010M
Copy books
UGZCOMMC
UHZCOMMC
(UGL0030P,UGL0031P)
(UHL0040P)
Appendix G – Functions Descriptions
374
Registry of Motor Vehicles – UMS Programmer’s Manual
IDMS LR UHL0040L-LR
DFHAID
IDMS SUBSCHEMA BINDS
(UHL0040P)
(UGL0030P)
(UHL0040P)
External name
ULP
Internal name
LI03
AVAILABLE FUNCTION KEYS:
F1 - Main Menu
F2 - UMS Submenu screen
F3 - Not available
F4 - Select from scroll
F5 - Not available
F6 - Not available
F7 - Page backward
F8 - Page forward
F9 - Not available
F10 - Not available
F11 - Not avaialble
F12 - Not available
NOTE: F4 requires function change
Appendix G – Functions Descriptions
375
Registry of Motor Vehicles – UMS Programmer’s Manual
RA Function
TITLE:
REGISTRATION AMEND
DESCRIPTION:
This screen is only available to non-remote sites or at town offices.
The RA Function is used to process changes or renewals for
Registrations. Entering a valid registration number or VIN
retrieves information on the screen. If a duplicate VIN or
registration is entered, a second screen will appear (USRS or
USRV) which will allow the user to select the correct record by
placing the cursor on the record and then hitting the F9 key to
return to the RA screen.
COMPONENTS:
Guest Input Program
UGR1271P
328001002 - NRES LINK ERROR
328001003 - NO CASH POSTING
328001015 - BAD NRES RC MSG
Guest Output Program
UGR1272P
Host Programs:
UHR1273P
328003000 - Address Problem
328003001 - Bad Date Load
328003002 - No Renew Msg
328003003 - No VEHC Action
328003004 - Action required
328003005 - Missing action msg
328003006 - F12 to update
328003007 - Print success
328003008 - Init please continue
328003009 - Invalid NOWN PERS
328003010 - Invalid NUM occur
328003011 - Inv IA action
328003014 - Batch success
328003015 - Duplicate batch number
328003016 - Closed batch print
328003017 - Bad print value
328003018 - Bad SYSID load
328003019 - Owner blocked
328003020 - INCP not found
328003021 - Drawer problem cash pgm
328003022 - Invalid RC cash pgm
Appendix G – Functions Descriptions
376
Registry of Motor Vehicles – UMS Programmer’s Manual
328003023 - Bad cash table search
328003024 - Msg VEHR not found
MAP:
UGR1270M
Table:
UGR1270T
Copy Books:
UGZCOMMY - Host Commarea
(UHR1273P,
UGR1272P,
UGR1271P)
UIR127AY - GSA/ Host-to-Guest Block
(UHR1273P,
UGR1272P,
UGR1271P)
UHR1273Y - RA Host Commarea
(UHR1273P)
UILXCNST - LX Table Constants
(UHR1273P,
UGR1271P,
UGR1272P)
MREYCSHC - Cash Code Table
(UHR1273P)
UHRCKNWY - Owner Blocking Action
(UHR1273P)
MREYUR1P - UR1 Print Layout
(UHR1273P)
MREYBADR - Address Work Area
(UHR1273P)
MREYBNME - Name Compression Area
(UHR1273P)
MREYPPNM - Plate Names Table
(UHR1273P)
MCCYCCRD - Credit Card Payment Interface
(UHR1273P)
UHUILOGY - Host Message Logging Parm
(UHR1273P)
WAAYCDAT - Waasdate Area
(UHR1273P)
UIGSPPRT - Online Reg/ Title Print Comm Area 1 (UHR1273P)
UIGSPUR1 - Online Reg/ Title Print Comm Area 2 (UHR1273P)
UIR1FLGY - Data Management Control Flags
(UHR1273P)
MREYEDIT - Plate Type/ Reg Format Editor
(UHR1273P)
UHR1EXLY - Excise Tax Record Builder
(UHR1273P)
UIR1COMR - ALARS Commarea
(UGR1271P)
External Name:
RA
Internal Name:
RA01
RA02
RA03
Appendix G – Functions Descriptions
377
Registry of Motor Vehicles – UMS Programmer’s Manual
AVAILABLE FUNCTION KEYS:
F1 - End Session
F2 - UMS Menu
F3 - Not Available
F4 - Not Available
F5 - Not Available
F6 - Not Available
F7 - Not Available
F8 - Not Available
F9 - Not Available
F10 - Not Available
F11 - Not Available
F12 - Update
Appendix G – Functions Descriptions
378
Registry of Motor Vehicles – UMS Programmer’s Manual
Appendix H:
CICS IDMS Network Relationships
NETWORK CONNECT OVERVIEW
------------]===] DATACOM ]
]
]___________]
AMDAHL 5890
AMDAHL 4745
]
---------------------]
------------] MVS/XA
]
] SNI/ ]=========]===] UMS USERS]
] VTAM
]=====]GATEWAY] NON
]
]___________] ----------] CICS
]
] NCPS ] NATIVE ]==================]NEW HAMP.]
] IDMS
]
]_______] NETWORKS]
------------- ]_________]
] TSO
]
]]
]===] CJIS/ENVOY]
]____________]
]]
]
]___________] ----------___]]____
]==================] OMIS
]
] RMV ]
]
------------- ]_________]
]NATIVE ]
]===]
IBM
]
]NETWORK]
]
]___________] ----------]_______]
]==================]
EDS
]
]_________]
KEY:
BOLD
= Vtam Applid
UNDERLINE = RMV Job Name
BOLDUNL
= IDMS CV
PRODUCTION
ENVIRONMENT
---------------------------------] OLSJCIAN ]
] USING ]===]===] UMS USERS]
] BAOCICA1 ]========]LU 6.2 ]
]
]___________] ----------]
ADMIN
]
] (ISC) ]
]==================]NEW HAMP.]
]
CV11
]
]_______]
]
------------- ]_________]
]____________]
]===] CJIS/ENVOY]
]
]___________]
Appendix H – CICS IDMS Network Relationships
379
Registry of Motor Vehicles – UMS Programmer’s Manual
*** MVA1CONN
]
]
------------]===]
IBM
]
]___________]
IVANS=IB1VNCIC
-------------] OLSJCIPN ]
] BAOCICP1 ]
]
PROD
]
]
CV11
]
]____________]
-------------_________
_______________
] OLSJCIEN ]
] USING ]
] IBM (NDR) ]
] BAOCICE1 ]=======]LU 6.2 ]======]_____________] AAMVANET=IB01USAN
]
NDRP
]
] (ISC) ]
]
CV11
]
]_______]
]____________]
*** MVE1CONN
*** = CEDA GROUP NAMES
TEST
ENVIRONMENT
---------------------------------] OLSJCIRN ]
] USING ]===]===] UMS USERS]
] BAOCICR1 ]========]LU 6.2 ]
]
]___________] ____________
]
MIRR
]
] (ISC) ]
]==================] BAOCICT1 ]
]
CV14
]
]_______]
]
------------- ]__________]
]____________]
]===] CJIS/ENVOY]
]
]___________] ----------*** MVR1CONN
]==================]BAOCICU1 ]
]
------------- ]_________]
]===] IBM (NDR) ]
]___________] IB1FNCIC
---------------------------------] OLSJCITN ]
] USING ]===]===] BAOCICR1 ]
] BAOCICT1 ]========]LU 6.2 ]
]
]___________] -----------]
TEST
]
] (ISC) ]
]==================]CJIS/ENVOY]
Appendix H – CICS IDMS Network Relationships
380
Registry of Motor Vehicles – UMS Programmer’s Manual
]
CV10
]
]____________]
*** MVT1CONN
]_______]
]
------------- ]__________]
]===] BAOCICS1 ]
]
]___________] -----------]==================] CICS/OS2 ]
]
------------- ]__________]
]===] BAOCICU1 ]
]___________]
Appendix H – CICS IDMS Network Relationships
381
Registry of Motor Vehicles – UMS Programmer’s Manual
------------]===] IBM(IVANS)] IB2WIBM1
]
]___________] _____________
---------------------]
------------- ] BAOCICG1 ]
] OLSJCIUN ]
] USING ]===]===] BAOCICR1 ]==]___________]
] BAOCICU1 ]========]LU 6.2 ]
]
]___________]
MVG1CONN
]
NDRT
]
] (ISC) ]
]
=MVG1
]
NO CV
]
]_______]
]
------------]____________]
]===] BAOCICS1 ]
]
]___________] -----------*** MVU1CONN
]==================]CJIS/ENVOY]
]
------------- ]__________]
]===] BAOCICT1 ]
]
]___________] -----------]==================] CICS/OS2 ]
]__________]
---------------------------------] OLSJCISN ]
] USING ]===]===] BAOCICT1 ]
] BAOCICS1 ]========]LU 6.2 ]
]
]___________]
]
SPCL
]
] (ISC) ]
]
]
CV13
]
]_______]
]
------------]____________]
]===] BAOCICU1 ]
]___________]
*** MVS1CONN
TRAINING ENVIRONMENT
-------------] OLSJCIMN ]
] BAOCICM1 ]
]
MODL
]
]
CV12
]
]____________]
*** = CEDA GROUP NAMES
Appendix H – CICS IDMS Network Relationships
382
Registry of Motor Vehicles – UMS Programmer’s Manual
MRO
ENVIRONMENT
------------]===] BAOCICM1 ]
]
]___________]
---------------------]
------------] OLSJCIUN ]
] USING ]
]===] BAOCICS1 ]
] BAOCICU1 ]========]LU 6.1 ]===]
]___________]
]
NDRT
]
] (MRO) ]
]
]
NO CV
]
]_______]
]
------------]____________]
]===] BAOCICT1 ]
]
]___________]
*** MVU1MRO
]
SYSID=MRU1
]
------------]===] BAOCICR1 ]
]___________]
---------------------------------] OLSJCIEN ]
] USING ]
]===] BAOCICA1 ]
] BAOCICE1 ]========]LU 6.1 ]===]
]___________]
]
NDRP
]
] (MRO) ]
]
]
CV11
]
]_______]
]
------------]____________]
]===] BAOCICP1 ]
]___________]
*** MVE1MRO
SYSID=MRE1
*** MVM1MRO
SYSID=MRM1
*** MVS1MRO
SYSID=MRS1
*** MVT1MRO
SYSID=MRT1
*** MVR1MRO
SYSID=MRR1
*** MVA1MRO
SYSID=MRA1
*** MVP1MRO
SYSID=MRP1
*** = CEDA GROUP NAMES
Appendix H – CICS IDMS Network Relationships
383
Registry of Motor Vehicles – UMS Programmer’s Manual
THE TMON V8.0 ENVIRONMENT
-------------] TMON8CSM ]
]
]
------------] INIT TST/ ]========================] OLSJCIUN ]
] NEW RELS. ]
]___________]
]____________]
-------------------------] TMONTCSM ]
]===] OLSJCIRN ]
]
]
]
]___________]
]TEST CLUSTER]====================]
]
]
]
------------]____________]
]===] OLSJCISN* ]
]
]___________] -----------]==================] OLSJCIMN ]
]
------------- ]__________]
]===] OLSJCITN ]
]___________]
-------------------------] TMONPCSM ]
]===] OLSJCIAN* ]
]
]
]
]___________]
]PROD CLUSTER]====================]
]
]
]
------------]____________]
]===] OLSJCIPN ]
]
]___________]
]
]
------------]===] OLSJCIEN ]
]___________]
* = TRIGGERS NIGHTLY DLS SWITCH PRIOR TO TMON MAINTENANCE
Appendix H – CICS IDMS Network Relationships
384
Registry of Motor Vehicles – UMS Programmer’s Manual
CICS - IDMS REGION RELATIONS
PRODUCTION
ENVIRONMENT
-------------------------] OLSJCIAN ]
] OLSJCIPN ]
+=====>] BAOCICA1 ]
] BAOCICP1 ]
]
]
]
]
]
ISC ]
]
CV11
]
]
CV11
]
]
]____________]
]___________]
----------]M]
]M]
] VARIOUS ]
]R]
]R]
____________
]INS. COS.]
]O]
]O]
]<=====>] AAMVANET ]
] (UMS) ]
-------------VIA
]<=====>] IB01USAN ]
]_________]
] OLSJCIEN ] IBMIN
]
]__________]
]____________]
ISC
]
___________
]M]
]<=====>] IVANS
]
]R]
] IB1VNCIC ]
]O]
]___(UMS)__]
-------------] OLSJCICN ]
] BAOCICA1 ]- USED WHEN AN AND PN ARE DOWN
]
BACKUP
] TO RECOVER CV11, ALLOWS LAW
]
CV14
] ENFORCEMENT INQUIRY ACCESS.
]____________]
Appendix H – CICS IDMS Network Relationships
385
Registry of Motor Vehicles – UMS Programmer’s Manual
TEST AND TRAINING ENVIRONMENT
-------------------------] OLSJCIUN ]
] OLSJCIMN ]
] BAOCICU1 ]
] BAOCICM1 ]
]
NDR
]<=== MRO ========>]
]
]
NO CV
]
]
CV12
]
]___________]
]____________]
]M]
]R]
]O]
================================
]
]
]
____________
]
------------------------- VIA ]<=>] AAMVANET ]
]
] OLSJCITN ]
] OLSJCIRN ] IBMIN ]
] IB1FNCIC ]
]
] BAOCICT1 ]
] BAOCICR1 ]<=====>]
]___(NDR)__]
]
]
] ISC ]
]
ISC ]
____________
]
]
CV10
]
]
CV14
]
]<=>] IVANS
]
]
]___________]
]___________]
] IB2WIBM1 ]
]
ISC
]M]
]___(UMS)__]
-------------]R]
] OLSJCISN ]
]O]
] BAOCICS1 ]
-------------]
]
] OLSJCIGN ]
]
CV13
]
] BAOCICG1 ]
]____________]
]
UMS TEST ] ON REQUEST
]
]
]
NO CV
]
]____________]
Appendix H – CICS IDMS Network Relationships
386