You can migrate from the old utilities NATUNLD/NATLOAD and SYSTRANS to the Object Handler by using the two methods described in this section.
You can convert NATUNLD/NATLOAD or SYSTRANS direct commands to the corresponding Object Handler commands by using the Object Handler commands provided for migration. These migration commands automatically convert the command syntax used by the old utilities to the command syntax used by the Object Handler.
To convert a single command
Use one of the following Object Handler direct commands:
NATUNLD
followed by a NATUNLD direct command.
Or:
NATLOAD
followed by a NATLOAD direct command.
Or:
SYSTRANS
followed by a SYSTRANS direct command.
The specified utility command is converted to the corresponding Object Handler command.
Specify any subsequent command for the Object Handler in the syntax that applies to the utility NATUNLD, NATLOAD or SYSTRANS respectively.
The syntax of this utility remains valid for the duration of the Object Handler session.
The following is an example of two consecutive NATUNLD utility commands and their corresponding Object Handler commands.
Old NATUNLD commands: | NATUNLD ALL * FM LIB1 TO
LIB2 |
ALL PG* FM LIB2 |
|
New Object Handler command: | SYSOBJH NATUNLD ALL * FM LIB1 TO LIB2
|
ALL PG* FM
LIB2 |
|
Subsequent Object Handler command in NATUNLD syntax: |
The following is an example of two consecutive SYSTRANS utility commands and their corresponding Object Handler commands.
Old SYSTRANS commands: | TRANSCMD EXECUTE UNLOAD N FROM LIB1 NAME ETID
|
END |
|
New Object Handler command: | SYSOBJH SYSTRANS EXECUTE UNLOAD N FROM LIB1 NAME
ETID END |
Subsequent Object Handler command in SYSTRANS syntax: | END |
The following is an example of processing a SYSTRANS utility command in batch by using map input data, and the corresponding Object Handler command and input data.
Old SYSTRANS batch sequence:
SYSTRANS U N,N,N,Y,N,N,N,N N SRCLIB1,PGM1,*,TGTLIB1
New Object Handler batch sequence:
SYSOBJH SYSTRANS U N,N,N,Y,N,N,N,N N SRCLIB1,PGM1,*,TGTLIB1
As an alternative to redefining each single utility command, you can specify in a user
exit routine that utility commands call SYSOBJH
for function
execution. This routine determines whether or not a direct commands issued to
NATUNLD/NATLOD or SYSTRANS is forwarded as an SYSOBJH
command
to the Object Handler.
To activate the user exit routine
For NATUNLD/NATLOAD:
SAVE
source object U-S-EX03 under the name UNLDEX03 in
the Natural system library SYSUNLD. The source object is supplied in SYSUNLD.
For SYSTRANS:
SAVE
source object TRA-E2-S under the name TRA-EX-2 in
the Natural system library SYSTRANS. The source object is supplied in SYSTRANS.
Open the source of UNLDEX03 or TRA-EX-2 respectively and set
USE-SYSOBJH
to Y
(this is the default value
entered). N
will deactivate the user exit routine.
You can define conditions for use such as when the Object Handler is to be used instead of an old utility or who is authorized to use the Object Handler.
CATALOG
or STOW
the source object.
You can use the OBJHAPI Application Programming Interface (supplied in the Natural system library SYSOBJH) to execute an Object Handler command in the syntax of the SYSTRANS utility.
If you use OBJHAPI for this purpose, you have to specify the parameter
P-EXTENSIONS-EXEC-SYSTRANS-CMD
in the program that invokes
OBJHAPI. For details, see the example program DOC-API supplied in the library SYSOBJH.
The Object Handler does not support the following SYSTRANS direct command options:
WORK-FILE-INPUT
, SPECIAL-CONVERSION
, RULE-LOAD
and UNLOAD-RULES
.