IPL levels parameters and setup

To set up and use IPL levels, use the following procedures. 

To set up IPL levels

  1. Specify names for the IPL levels and the order in which to use them in the IPLORDER parameter in the MAMINIxx member. Each level name can be up to 8 characters in length. Level names are separated by commas.
  2. Specify Y in the IPLO or IPLL parameter in the TOM PAS JCL member.

(Optional) To specify an IPL level for an object

  1. Navigate to the Specify General Object Information dialog box by editing an object (model or non-model).

  2. In the IPL Level field, type a level attribute, such as BASIC. Alternatively, to view a list of defined IPL levels, type ? in the field, select a level, and press END to return to the Specify General Object Information dialog box.

    Important

    If you have specified Y in the IPLO or IPLL parameter and you don't specify an IPL level, the object is the last, unnamed level by default.

Related topics

How-to-start-TOM

Using-IPL-levels

Controlled-starting-of-objects-during-IPL-with-IPLLEVEL

START-function

STOP-function

If you are doing a mass edit of the definition base by using ISPF edit and you want to set an IPL level for an object, set the following assignment statement:

line.ipllevel = ‘BASIC'

To start objects using IPL levels during startup

  1. Start TOM. The first level automatically starts and TOM starts objects associated with the first IPL level named in the IPLORDER parameter.
  2. When all the objects in the first level have been started, TOM pauses the startup. When you are ready to continue with the startup, use the START IPLLEVEL command or the TOMEXEC FUNC(START) API call to start objects in the next level.
  3. After you have processed all the defined IPL levels and you still have remaining objects to start, issue the START IPLLEVEL command or the TOMEXEC FUNC(START) API call again. TOM starts the objects according to the dependency order.

For more information about the START IPLLEVEL request, see the discussion "How the TOMEXEC FUNCTION START IPLLEVEL command starts objects" in the START-function topic.

To stop objects using IPL levels during shutdown

  1. Use the STOP IPLLEVEL command or the TOMEXEC FUNC(STOP) API call to stop objects during system shutdown. TOM begins terminating objects associated with the last IPL level named in the IPLORDER parameter.
  2. When all the objects in the level have been terminated, TOM pauses the shutdown. When you are ready to continue with the shutdown, use the STOP IPLLEVEL command or the TOMEXEC FUNC(STOP) API call to stop objects in the next level.
  3. When you are at the lowest IPL level, and you still have remaining objects to stop, TOM notifies you to use the SHUTSYS command or the TOMEXEC FUNC(STOP) API call. TOM stops the rest of the objects in the system.

For more information about the STOP IPLLEVEL command, see the discussion "How the TOMEXEC FUNCTION STOP IPLLEVEL command stops objects" in the STOP-function topic.

Tip

Like other TOM commands, you can also issue the START IPLLEVEL and STOP IPLLEVEL commands as a Rule action.

The IPLORDER parameter in MAMINIxx dictates the order in which the IPL levels are processed. For more information about using the IPLORDER parameter, see Controlled-starting-of-objects-during-IPL-with-IPLLEVEL.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*