$POLICY IMPORT - Import new JES2 policy

Function

To add new policy to JES2 configuration. This command processes JES2 policy definition in human-readable external representation (in JSON notation), converts the policy into internal representation that is used by JES2 and makes the policy available for JES2 processing.

For more information about JES2 policies, see z/OS JES2 Installation Exits.

Syntax

Parameters

POLICYlib=policylib: Specifies the 1 to 8 name of a POLICYLIB concatenation that contains the definition of a JES2 policy in the human-readable external representation (JSON notation). This POLICYLIB concatenation must be created by using $ADD POLICYLIB(xxxxxxxx) - Define a new concatenation for JES2 policy import command before using $POLICY IMPORT command.
MEMBER=mbrname: Specifies the 1 to 8 character name of a member in POLICYLIB concatenation specified by POLICYLIB= keyword. Depending on POLICYLIB concatenation definition, this might be a name of a member in a partitioned data set (PDS) or a name of a file in a directory in zFS file system. Enclose the name in single quotation marks if the file name in the zFS file system contains lowercase characters.
Note: This is not a policy name. Policy name is specified within a policy definition that is found in the member.
REPLACE={No|Yes}: Determines the decision if policy with the same name already exists in JES2 configuration. If REPLACE=NO is specified, command fails. If REPLACE=YES is specified, existing policy is replaced with the new policy with the same name. Default is REPLACE=NO.
ENABLE={Yes|No}: Determines the state of the policy after it is successfully imported. If ENABLE=YES is specified, policy is imported in enabled state and is immediately available for JES2 processing. If ENABLE=NO is specified, policy is imported in disabled state. Disabled policy is not available for JES2 processing until it is enabled by the $POLICY ENABLE $POLICY ENABLE - Enable JES2 policy command. Default is ENABLE=YES.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.

Scope

MAS-Wide. Policy that is imported by the command becomes available for all MAS members.

Note: The support to allow JES2 MAS scope for the JES2 policies and to provide persistent storage for the JES2 policies is available with the PTF for APAR OA58190.

Messages

The command is executed asynchronously. If command parameters are entered correctly, the $HASP1600 message acknowledges that command was accepted for execution. Command goes through several stages of processing. Multiple status or error messages can be issued during this processing. The messages are documented in z/OS JES2 Messages

$HASP1601 message is issued when command processing completes successfully. $HASP1602 message is issued if command fails.

Examples

 1 
$policy import,policylib=p1,member=policy2
$HASP1600 POLICY IMPORT request accepted. 
$HASP1603 Validation of policy JOB2 type JobConversion is complete. 
$HASP1611 Policy JOB2 type JobConversion saved in the JES2 checkpoint. 
$HASP1614 Policy JOB2 type JobConversion added to runtime repository. 
$HASP1601 IMPORT policy JOB2 request complete.

Import policy from member POLICY2 in POLICYLIB concatenation. Policy that is defined in this member is found to have name JOB2 and type JobConversion. Policy is imported in the enabled state.