Creating a recipient ID

You can create a recipient ID to specify printing parameters that pertain to the recipient only or to use as a "bundle recipient."

About this task

To create a recipient ID:

Procedure

  1. From the Output Manager main menu, choose option A, Administrative Functions, and press Enter.
  2. From the Administrative Functions menu, choose option J, Recipient IDs, and press Enter.
  3. Specify search criteria, or leave the fields blank, and press Enter.
    The resulting list is filtered by your search criteria.
  4. Type ADD on the command line and press Enter.
    The Recipient Details panel is displayed.
    Tip: Once a recipient ID has been defined, you can type I (Insert) In the CMD column and press Enter to display the Recipient Details panel.
  5. In the Name field, type the name of the recipient. (Required)
  6. Specify information in the other fields on this panel, as needed.
    Tip: These fields correspond to JCL parameters for the output statement. For more information about the parameters, refer to the z/OS® MVS™ JCL Reference Manual.
    Name
    (Required) The name of the recipient (a person or location). This name can be up to 60 characters in length. Corresponds to the NAME parameter.
    User ID
    Type up to eight (8) characters for the MVS user ID, RACF® Group ID, or wildcarded MVS User ID for the recipient(s). If you specify an MVS User ID, you can include one wildcard (*) as the right-most character. You must specify a recipient user ID if that user is to be able to view or print reports for a report that a recipient is to receive.
    Note: If you specify a RACF group name in this field, RACF groups must have an MVS group ID, and everyone in the RACF group must have the same permissions. RACF groups in distribution lists are for online viewing only.
    This field can be left blank when the Recipient record is to be used for one or more of the following cases:
    • Bundle delivery details in a Report Bundle definition
    • To define an Access ID that will be used to group report access rights
    • When the Recipient record is used only for the purposes of hardcopy printing or email distribution
    If left blank, this recipient is not associated with any MVS user, and can only be used in distribution lists in which the Hardcopy option is set to YES for this recipient, or if report email is configured for this recipient.
    Access ID
    The Access ID is used to determine which reports a user has access to. This ID is similar to a User ID, but unlike the User ID, the Access ID can be assigned by the report administrator.

    If allowed by the Access Mask associated with the Access ID, the user may have the ability to change their Access ID during their session. This ID can be changed by the user ONLY IF allowed by the associated Access Mask.

    Access Mask
    The access mask, which is derived from the access ID, determines whether or not a user can change their Access ID during a session. To allow a user to change their Access ID, specify an Access ID with a trailing asterisk (*) wildcard. To prevent a user from changing their Access ID, specify a fully-qualified Access Mask.

    Example of an Access Mask with a wildcard:

    ACCID = XYZ1

    ACCMASK = XYZ*

    In this example, the user's initial Access ID is XYZ1, but the user has permission to change their Access ID to any value beginning with XYZ. According to the mask, valid values for this user's Access ID include XYZ1, XYZ2, XYZ3, etc.

    Example of a fully-qualified Access Mask:

    ACCID = XYZ1

    ACCMASK = XYZ1

    In this example, the user's Access ID is XYZ1, and the user is not able to change this to any other value.

    Department
    The name of the recipient's department. This name can be up to 60 characters in length. Corresponds to the DEPT parameter.
    Room
    The identifier for the recipient's room or office. This value can be up to 60 characters in length. Corresponds to the ROOM parameter.
    Building
    An identifier for the building in which the recipient is located. This value can be up to 60 characters in length. Corresponds to the BUILDING parameter.
    Address
    The recipient's mailing address. This value can be up to four lines long, each line containing from 1 to 60 characters. Corresponds to the ADDRESS parameter.
    Output Manager uses any Dest, Class, and Copies values that you specify in a recipient ID only if you set the Print Model field to Classic. You also must either set the Dynamic Print field to No, or if you enable the use of the "dynamic printing parameters," ensure that your jobs do not include the Class and Dest parameters.
    Dest
    The destination for a SYSOUT data set. This destination can be a remote or local terminal, a node, a node and remote workstation, a local device or group of devices, or a node and user ID. Corresponds to the DEST parameter.
    Class
    The output class to which a SYSOUT data set is assigned. This value must be one alphanumeric character. Corresponds to the CLASS parameter.
    Groupid
    The group ID of the output group to which the report data sets belong. This ID can be up to eight characters in length. The data sets in an output group are processed together at the same location and time. They should have similar characteristics, for example, the same output class, destination, process mode, and external writer name. Corresponds to the GROUPID parameter.
    Note: The GROUPID parameter is supported only on JES2 systems.
    Copies
    The number of copies of a report to print. This value must be a number from 0 to 255. Corresponds to the COPIES parameter.
    Duplex
    The duplex mode in which a report is to be printed. Valid values are:
    • No - The report is printed on one side of the paper only (not duplexed).
    • Normal - The report is printed on both sides the paper (duplexed) and is bound along the long edge of the paper.
    • Tumble - The report is duplexed and is bound along the short edge of the paper.

    Corresponds to the DUPLEX parameter.

    Burst
    Whether the printed report pages are separated by a trimmer-stacker device or left in a continuous fanfold. Valid values are: Yes (the output is "burst" onto separate sheets) and No (the output is left in a continuous fanfold of sheets). Corresponds to the BURST parameter. This option applies only to data sets that are printed on a 3800 Printing Subsystem that has a burster-trimmer-stacker.
    Label
    Whether to print a security label with the report. A security label presents the security level and categories as defined to RACF. Valid values are: Yes (print a security label) and No (do not print a security label).
    Sys Area
    Whether the system should reserve an area on each page of printed output for the security label. Valid values are: Yes (reserve an area for the security label) and No (do not reserve an area for the security label). Corresponds to the SYSAREA parameter.
    Note: When a system area is reserved for a security label, the system shifts the printed output on each page. You cannot print output data in the system area.
    Attr Usage
    The printing scenario in which the linked set of printer attributes (specified in the Print Attr field) is to be used for the recipient. Valid values are: Reprint, Print, Real, None, All, Requested, Custom, and Mixed. For descriptions of these options, see Creating a set of printer attributes.
    Print Attr
    The name of the set of printer attributes that is linked to the recipient ID, if any. You can link a set of printer attributes to the recipient from the Links menu. If you do so, you must also specify a value in the Attr Usage field.
    Rept Title
    A title to include on the separator pages of the printed report for this recipient (for example, "Annual Report"). This value can be up to 60 characters in length. Corresponds to the TITLE parameter.
  7. Press F3 (Exit). An exit confirmation window is displayed.
  8. Press Enter to save the recipient ID.