Previous Topic: Syntax DiagramNext Topic: YCHKIFSOBJ (Check IFS Object)


Parameters

Parameter

Definition

Value and Description

OBJ

Qualified generic name of objects whose ownership is to be changed

  • *OBJLST: Objects are specified by a list whose name is given by the OBJLST parameter
  • *ALL: all objects

USRPRF

User profile name

 

PASSWORD

A valid User password name

  • SAME: (default) The previous value remains unchanged
  • *NONE: Profile has no password. USRCLS User class. One of the following values:
  • *USER: Defined as a user
  • *SECOFR: User has security officer class
  • *SECADM: User has administration class.
  • *PGMR: Defined as a programmer
  • *SYSOPR: User has system operator class

CURLIB

Default current library for this user

  • *SAME: (default) The previous value remains unchanged
  • *CRTDFT: This user has no default create library. The library QGPL is used as the default library

INLPGM

Qualified name of initial program for profile. This program is the first program to execute when the user signs on

  • *SAME: (default) The previous value remains unchanged
  • *NONE: There is no initial program for the profile
  • *LIBL/YINLPGM: (default) The initial program is the first program to execute

INLMNU

Qualified name of initial menu for profile. This menu is called if there is no initial program, and if an initial program executes a return

  • *SAME: (default) The previous value remains unchanged
  • *SIGNOFF: Executes a signoff command if the initial program executes a return

LMTCPB

Limit capability of user to change user profile

  • *SAME: (default) The previous value remains unchanged
  • *NO: Do not limit capability
  • *YES: Limit capability
  • *PARTIAL: Partial limitation

SPCAUT

Special authorities. Either single value

  • *SAME: (default) The previous value remains unchanged
  • *NONE: No special authorities are to be granted
  • *USRCLS: Authorities are defined by user class
  • *Or a list of up six special values:

    – *SAVSYS: Grant save system rights

    – *JOBCTL: Grant job control rights

    – *SECADM: Grant administrator rights

    – *ALLOBJ: Grant rights to all objects

    – *SERVICE: Grant service rights

    – *SPLCTL: Grant spool control rights

JOBD

Qualified name of initial job description defining the initial job environment when the user signs on

  • *SAME: (default) The previous value remains unchanged
  • QDFTJOBD: The system-supplied job description in library QGPL is used

GRPPRF

Group profile name

  • *SAME: (default) The previous value remains unchanged
  • *NONE: Profile is not a group profile member

Owner

Owner of created objects for group members. If a value of GRPPRF(*NONE) is specified then *USRPRF must be specified

  • *SAME: (default) The previous value remains unchanged
  • *USRPRF: The user profile is to own any objects created by the profile
  • *GRPPRF: The group profile is to own any created objects

GRPAUT

Authority given to the group profile for newly created objects. If OWNER (*GRPPRF) is specified *NONE is required

  • *SAME: (default) The previous value remains unchanged
  • *NONE: No authority is given to the group profile
  • *ALL: All authority is given to the group profile
  • *CHANGE: Change authority for the object type is given to the group profile
  • *USE: Authority to use the object type is given to the group profile
  • *EXCLUDE: User profile is excluded

MSGQ

Qualified name of message queue associated with the user profile

  • *SAME: (default) The previous value remains unchanged
  • *USRPRF: A message queue with the same specified name as in the USRPRF parameter and used as the message queue for the user

DELVRY

Mode of delivery for messages sent to specified message queue

  • *SAME: (default) The previous value remains unchanged
  • *HOLD: Messages are to be held on the message queue
  • *BREAK: Messages of the appropriate severity are displayed at the time of delivery. The severity level is determined by the value specified for SEV
  • *NOTIFY: Messages of the appropriate severity cause the message waiting indicator to be displayed
  • *DFT: All information messages are ignored and other messages are held. Any enquiry messages are given the default reply specified on the job description, or on the message description

SEV

Message severity to use when setting message queue delivery

  • *SAME: (default) The previous value remains unchanged
  • 00/99: Message severity. See i OS manual for message severity code meanings

PRTDEV

Name of the printer associated with the user

  • *SAME: (default) The previous value remains unchanged
  • *SYSVAL: Use the printer device specified by the system value QPRTDEV

OUTQ

Qualified name of output queue associated with the user profile

  • *SAME: (default) The previous value remains unchanged
  • *DEV: Output is to be directed to the output queue having the same name as the printer device specified on the PRTDEV parameter

ATNPGM

Qualified name of the attention key program associated with the user profile

  • *SAME: (default) The previous value remains unchanged
  • *NONE: No attention key program is associated with the user profile

If an attention program is specified, the job automatically changes into a group job.

AUT

Authority given to the public for the user profile

  • *SAME: (default) The previous value remains unchanged
  • *ALL: All authorities are given to the public
  • *CHANGE: Change authority for the profile given to the public
  • *USE: Authority to display the profile is given to the public
  • *EXCLUDE: No authority is given to the public

LIBLST

Qualified name of initial library list set at start of sign-on

  • *SAME: (default) The previous value remains unchanged
  • *SYSVAL: Uses the system default library list
  • *USER: Uses a library list with the same name as that specified in the USRPRF parameter

MENU

Name of initial profile user menu

  • *SAME: (default) The previous value remains unchanged
  • *USER: Uses an initial menu with the same name as that specified in the USRPRF parameter
  • *NONE: There is no initial menu

MENUOPT

The profile for the initial menu option

  • *SAME: (default) The previous value remains unchanged
  • *NONE: The initial menu is displayed
  • menu-option: Executes the program/command specified by the initial menu option

MENUFILE

Qualified file name and must be a menu file

  • *SAME: (default) The previous value remains unchanged
  • *LIBL/YDSNMNU: The default menu file name
  • *NONE: No initial menu is displayed

MENUMBR

Menu file member name

  • *SAME: (default) The previous value remains unchanged
  • *FILE: The member name is the name specified in the FILE parameter

ALWMNUENT

Allow menu name entry from the menu display

  • *SAME: (default) The previous value remains unchanged
  • *NO: The user is not permitted to enter menu names. The user is restricted to the displayed menu options
  • *YES: The user can enter menu names to transfer directly to the named menu

ALWCMDENT

Allow command entry from the menu display

  • *SAME: (default) The previous value remains unchanged
  • *NO: The user is not permitted to enter commands and is restricted to the displayed menu options.
  • *YES: The user may enter and execute commands directly from the menu

CHKMNUAUT

Checks user authorization to menu options while loading menus

  • *SAME: (default) The previous value remains unchanged
  • *NO: When loading a menu, do not check the user’s authorization to use the program or command named for each menu option
  • *CHKOBJ: When loading a menu, check the user’s authorization to use the program or command named for each executable menu option

DTAAUT

Data authority level (1-high to 9-low)

This value is available directly from the file YUSRPRF in the library, or via the YRTVUSRPRF command in a CL program. It can be used to provide a simple form of field level authorization, For example, levels 4 and above can view a salary field. Checking must be provided by user code

*SAME: (default) The previous value remains unchanged

SBMJOBD

Qualified job description for submitted jobs

This job description is used by the menu display program for menu options having the submit option

  • *SAME: (default) The previous value remains unchanged
  • *JOBD: Use the value specified on the JOBD parameter

LOGOFF

Sign off option

  • *SAME: (default) The previous value remains unchanged
  • *NOLIST: No job log is to be created
  • *LIST: A job log is to be created

HOLD

Hold/release user profile option

  • *SAME: (default) The previous value remains unchanged
  • *NO: The user may sign-on
  • *YES: The user is prevented from signing on

EXCPMSGQ

Qualified name of exception message queue. Profile associated with the user profile and a copy of any exception message received by the display menu program is sent to this queue

  • *SAME: (default) The previous value remains unchanged
  • *NONE: No exception message is associated with the profile

PWDEXPDAT

Date password expires

  • *SAME: (default) The previous value remains unchanged
  • *NONE: There is no expiry date

PWDEXPDAYS

Number of days after date of last change that a password is to remain valid

  • *SAME: (default) The previous value remains unchanged
  • *NOMAX: There is no limit to the number of days that the password remains valid 1-999: Number of days

PWDEXPOPT

Action that YINLPGM is to take if password expiry is detected for a user at sign-on

  • *SAME: (default) The previous value remains unchanged
  • *NOSIGNON: Prevent user from signing on
  • *PMTCHG: Prompt user for new password, providing number of days specified by PWDEXPPRD parameter has not been exceeded

PWDEXPPRD

Number of days after password has expired that user is still allowed to sign on, providing the password is changed

  • *SAME: (default) The previous value remains unchanged
  • *NONE: The user may not sign on after the password has expired. 1-999: Number of days

TEXT

Text associated with user profile

  • *SAME: (default) The previous value remains unchanged