dtxpage utility command

The dtxpage utility command is used to invoke the Page Setting Assistant for Maps application to calculate suggested settings for memory page size and count for work files used in maps. To use this utility command, the Command Server must be installed.

The dtxpage utility command returns 0 if the calculations are successful, and 1 if not successful. It is a batch operation that can also be used for automation.

The .mmc file is a required parameter and is the file name of the map for which the page size and count is being calculated. If the full path of the map file name is not specified, the dtxpage utility command will search for the map in the current directory.

The Page Setting Assistant for Maps application will run iterations of the specified map to calculate suggested memory page size and count settings. Because of the multiple iterations of map runs, the overall run time will be longer than a typical run. Because of the additional run time, follow these guidelines:

  • use a smaller representation of the input data when you are using a map that normally takes a long time to run
  • use this utility command only when there is a limited number of other processes running so that CPU utilization is not adversely affected

See "Troubleshooting" for details about capturing and evaluating the return code resulting from the execution of this utility command.

You can use the dtxpage utility command to calculate suggested settings for memory page size and count for work files used in maps that you are running with the z/OS Batch Command Server. See z/OS Batch Command Server dtxpage Usage.