You can migrate from the old utility SYSTRANS to the Object Handler by using the two methods described in this section.
You can convert SYSTRANS direct commands to the corresponding Object Handler direct commands by using the Object Handler direct command provided for migration. This migration command automatically converts the command syntax used by SYSTRANS to the command syntax used by the Object Handler.
To convert a single command
Use the following Object Handler direct command:
SYSTRANS
followed by a SYSTRANS direct command.
The specified SYSTRANS command is converted to the corresponding Object Handler command.
Specify any subsequent command for the Object Handler in the syntax that applies to the SYSTRANS utility.
The syntax of SYSTRANS remains valid for the duration of the Object Handler session.
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
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.
