Version 6.3.8 for OpenVMS
 —  Tools and Utilities  —

Migration from NATUNLD/NATLOAD and SYSTRANS to the Object Handler

You can migrate from the old utilities NATUNLD/NATLOAD and SYSTRANS to the Object Handler by using the two methods described in this section.


Converting Individual Commands

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.

Start of instruction setTo convert a single command

  1. 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.

  2. 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.

Example of a NATUNLD Command:

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:

Example of a SYSTRANS Command:

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

Example of SYSTRANS Batch Processing:

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

Top of page

Processing SYSTRANS Commands with OBJHAPI

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.

Top of page

Unsupported SYSTRANS Options

The Object Handler does not support the following SYSTRANS direct command options: WORK-FILE-INPUT, SPECIAL-CONVERSION, RULE-LOAD and UNLOAD-RULES.

Top of page