Edit Object Authority (EDTOBJAUT)

Edit Object Authority (EDTOBJAUT)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No Parameters
Examples
Error messages

The Edit Object Authority (EDTOBJAUT) command displays the list of authorized users of an object and their associated user authorities. If you own the object, or have *ALLOBJ special authority, you can add, change or remove authority for the object. If you have object management authority for the object, you can remove your specific authorities or grant or remove them for other users.
The following are displayed for the specified object:

The object name
The name of the library containing the object
The name of the object's owner
The object's type
A list of all the users who are authorized to use the object
The authority that each user has for the object
The authorization list name is displayed when the object is secured by an authorization list.

If an object does not have an owner name associated with it, no authorities for the object are shown.
Restrictions:

The user must have object management authority to the object to use this command.
If the object is a file, the user must have object operational and object management authorities.
You must have *USE authority to the auxiliary storage pool device if one is specified.

Top

Parameters

Keyword Description Choices Notes
OBJ Object Qualified object name Required, Positional 1
Qualifier 1: Object Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OBJTYPE Object type *ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DTAARA, *DTADCT, *DTAQ, *EDTD, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCTBL, *IGCSRT, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *M36, *M36CFG, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *S36, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST Required, Positional 2
ASPDEV ASP device Name, *, *SYSBAS Optional

Top

Object (OBJ)

Specifies the object for which the authorized users and their authorities are to be shown.
This is a required parameter.

name

Specify the name of the object.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.

name

Specify the name of the library to be searched.

Top

Object type (OBJTYPE)

The object type, such as command (*CMD), file (*FILE), or program (*PGM), of the object whose authorized users and authorities are to be shown. To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt).
This is a required parameter.

Top

ASP device (ASPDEV)

Specifies the auxiliary storage pool (ASP) device name where the library that contains the object (OBJ parameter) is located. If the object's library resides in an ASP that is not part of the library name space associated with the job, this parameter must be specified to ensure the correct object is used as the target of this command's operation.

*

The ASPs that are currently part of the job's library name space will be searched to locate the object. This includes the system ASP (ASP number 1), all defined basic user ASPs (ASP numbers 2-32), and, if the job has an ASP group, all independent ASPs in the ASP group.

*SYSBAS

The system ASP and all basic user ASPs will be searched to locate the object. No independent ASPs will be searched, even if the job has an ASP group.

name

Specify the device name of the independent ASP to be searched to locate the object. The independent ASP must have been activated (by varying on the ASP device) and have a status of AVAILABLE. The system ASP and basic user ASPs will not be searched.

Top

Examples
 EDTOBJAUT   OBJ(ARLIB/PROG1)  OBJTYPE(*PGM)
This command causes the list of authorized users and their authorities for the object named PROG1 to be shown, but only if the user has object management authority for the object. PROG1 is a program (*PGM) located in the library named ARLIB.

Top

Error messages

*ESCAPE Messages

CPF22B8

Not authorized to change authorities.

CPF22B9

Not authorized to change authorities.

CPF2204

User profile &1 not found.

CPF2207

Not authorized to use object &1 in library &3 type *&2.

CPF2208

Object &1 in library &3 type *&2 not found.

CPF2209

Library &1 not found.

CPF2211

Not able to allocate object &1 in &3 type *&2.

CPF2216

Not authorized to use library &1.

CPF2217

Not authorized to user profile &1.

CPF2283

Authorization list &1 does not exist.

CPF9843

Object &1 in library &3 type &2 cannot be accessed.

Top

Keyword	Description	Choices	Notes
OBJ	Object	Qualified object name	Required, Positional 1
	Qualifier 1: Object	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OBJTYPE	Object type	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRG, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DTAARA, DTADCT, DTAQ, EDTD, FCT, FILE, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCTBL, IGCSRT, IMGCLG, IPXD, JOBD, JOBQ, JOBSCD, JRN, JRNRCV, LIB, LIND, LOCALE, M36, M36CFG, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, NODGRP, NODL, NTBD, NWID, NWSCFG, NWSD, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, RCT, S36, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SRVPGM, SSND, SVRSTG, TBL, TIMZON, USRIDX, USRPRF, USRQ, USRSPC, VLDL, *WSCST	Required, Positional 2
ASPDEV	ASP device	Name, , SYSBAS	Optional