UOA:OMQCHGRT

From Remain Software
Jump to navigation Jump to search

Route Location API (OMQCHGRT) - Help

Route Location API (OMQCHGRT)

This Application Program Interface command allows you to manipulate the TD/OMS database. This can be done from a command line or from within your programs.

The command enables you to perform all allowed actions on a Route location. You can use this command to add, update, and delete the Route.

Action code

Specify the action to be performed. The possible values are:

*ADD
Use this action code to add the route code.
*CHANGE
Use this action code to change the route code.
*DELETE
Use this action code to remove the route code.

Application code

Specify the application code. See the description of the application code for more information.

Route code

The route code specifies the 'path' that an object follows through the environments. In every environment, a route has a directory connected to it. During Object Transfer, the object always stays in the same route. TD/OMS uses this route to search for the target-directory where the object will be located.

Route description

This is a description of the route. In most cases, the name of the route should be a good description on its own, but the description can further clarify the purpose of a route.

*SAME
Use this value to indicate that the route description does not

change if you are in change mode.

Recursive route indicator

This field indicates the recursiveness of the route. In case of the recursive route, objects in subdirectories of the directory that is linked to the route, are also loaded in the TD/OMS database.

*SAME
Use this value to indicate that the recursive route does not

change if you are in change mode. The default value for the recursive route is '*NO'.

*NO
It set the value as '0' for the recursive route.
*YES
It set the value as '1' for the recursive route.

Archive Location

The archive location is the directory in which the archived object is located. This is a path from the root of the integrated file system(IFS).

This archive location will be part of the Route definition that is maintained by the current function. This directory is used as the file location when IFS files residing in this Route and containing source code, are archived at the start of a maintenance cycle. In order to tell TD/OMS which IFS objects are source type files and to start the source archive procedure in a specific Application and/ or a specific Route, a registry entry defined by the keyword OMIFSSRCEXT must be added to the TD/OMS general registry file.

*SAME
Use this value to indicate that the archive location does not

change if you are in change mode. The default value for the archive location is blank.

Ignore warning

Specify the warning indicator. The possible values are:

*NO
Use this value if you do not want to ignore the warnings.
*YES
Use this value to ignore the warnings.