Attributes compared and expected results - #OBJATR audit - assure_MIMIX™ Software - assure_mimix - 10.0

Assure MIMIX Administrator Reference

Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software
Version
10.0
Language
English
Product name
Assure MIMIX
Title
Assure MIMIX Administrator Reference
Copyright
2023
First publish date
1999
ft:lastEdition
2024-05-07
ft:lastPublication
2024-05-07T13:36:02.962500

The #OBJATR audit calls the Compare Object Attributes (CMPOBJA) command and places the results in an output file. Table 146 lists the attributes that can be compared by the CMPOBJA command and the value shown in the Compared Attribute (CMPATR) field in the output file. The command supports attributes that are common among most library-based objects as well as extended attributes which are unique to specific object types, such as subsystem descriptions, user profiles, and data areas. The Returned Values column lists the values you can expect in the System1 Value (SYS1VAL) and System 2 Value (SYS2VAL) columns as a result of running the compare.

Compare Object Attributes (CMPOBJA) attributes

Attribute

Description

Returned Values (SYS1VAL, SYS2VAL)

*ACCPTHSIZ1 2

Access path size

Valid for logical files only.

*MAX4GB and *MAX1TB

*AJEIND

Auto start job entries.

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of auto start job entries, job entry and associated job description, and library entry values are equal.

*ASP

Auxiliary storage pool ID

1-16 (pre-V5R1)

1-32 (V5R1)

1-255 (V5R2), 1 = System ASP

See Comparison results for auxiliary storage pool ID (*ASP) for details.

*ATTNPGM2 

Attention key handling program

Valid for user profiles only.

*SYSVAL, *NONE, *ASSIST, attention program name

*AUDVAL

Object audit value

*NONE, *USRPRF, *CHANGE, *ALL

*AUT

Authority attributes

Group which checks *AUTL, *PGP, *PRVAUTIND, *PUBAUTIND

*AUTCHK2 

Authority to check.

Valid for job queues only.

*OWNER, *DTAAUT

*AUTL

Authority list name

*NONE, list name

*BASIC

Pre-determined set of basic attributes

Group which checks a pre-determined set of attributes. These attributes are compared: *CRTTSP, *DOMAIN, *INFSTS, *OBJATR, *TEXT, and *USRATR.   

*CCSID2 

Character identifier control.

Valid for user profiles only.

*SYSVAL, ccsid-value

*CNTRYID2 

Country ID

Valid for user profiles only.

*SYSVAL, country-id

*COMMEIND

Communications entries

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of communication entries, maximum number of active jobs, communication device, communication mode, associated job description and library, and the default user entry values are equal.

*CRTAUT2 

Authority given to users who do not have specific authority to the object.

Valid for libraries only.

*SYSVAL, *CHANGE, *ALL, *USE, *EXCLUDE, *SYSVAL, *CHANGE, *ALL, *USE, *EXCLUDE

*CRTOBJAUD2 

Auditing value for objects created in this library

Valid for libraries only.

*SYSVAL, *NONE, *USRPRF, *CHANGE, *ALL

*CRTOBJOWN

Profile that owns objects created by user

Valid for user profiles only.

*USRPRF, *GRPPRF, profile-name

*CRTTSP

Object creation date

YYYY-MM-DD-HH.MM.SS.mmmmmm

*CURLIB

Current library

Valid for user profiles only.

*CRTDFT, current-library

*DATACRC

Data cyclic redundancy check (CRC)

Valid for data queues2, message files, query definitions, query management forms4, and validation list entries only.

10 character value

The value *EC is returned for *DTAQ objects with differences that were identified by configuration that specify to omit content of *DTAQ objects.

The value *NS is returned for *MSGF objects when one or both systems is not running IBM i 7.3 Technical Refresh TR6 or higher.

*DDMCNV2 

DDM conversation

Valid for job descriptions only.

*KEEP, *DROP

*DECPOS

Decimal positions

Valid for data areas only.

0-9

*DOMAIN

Object Domain

*SYSTEM, *USER

*DTAARAEXT

Data area extended attributes

Group which checks *DECPOS, *LENGTH, *TYPE, *VALUE

*EXTENDED

Pre-determined, extended set

Group which compares the basic set of attributes (*BASIC) plus an extended set of attributes. The following attributes are compared: *AUT, *CRTTSP, *DOMAIN, *INFSTS, *OBJATR, *TEXT, and *USRATR.                                                        

*FRCRATIO1 2 

Records to force a write

Valid for logical files only.

*NONE, 1 - 32,767

*GID

Group profile ID number

Valid for user profiles only.

1 - 4294967294

*GRPAUT

Group authority to created objects

Valid for user profiles only.

*NONE, *ALL, *CHANGE, *USE, *EXCLUDE

*GRPAUTTYP

Group authority type

Valid for user profiles only.

*PGP, *PRIVATE

*GRPPRF

Group profile name

Valid for user profiles only.

*NONE, profile-name

*INFSTS

Information status

*OK (No errors occurred), *RTVFAILED (No information returned - insufficient authority or object is locked), *DAMAGED (Object is damaged or partially damaged).

*INLMNU

Initial menu

Valid for user profiles only.

Menu - *SIGNOFF, menu name

Library - *LIBL, library name

*INLPGM

Initial program

Valid for user profiles only.

Program - *NONE, program name

Library - *LIBL, library name

*JOBDEXT

Job description extended attributes

Group which checks *DDMCNV, *JOBQ, *JOBQLIB, *JOBQPRI, *LIBLIND, *LOGOUTPUT, *OUTQ, *OUTQLIB, *OUTQPRI, *PRTDEV

*JOBQ2 

Job queue

Valid for job descriptions only.

10 character name

*JOBQEIND

Job queue entries

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of job queue entries, job queue names, job queue libraries, and order of entries are the same

*JOBQEXT

Job queue extended attributes

Group which checks *AUTCHK, *JOBQSBS, *JOBQSTS, *OPRCTL

*JOBQLIB2 

Job queue library

Valid for job descriptions only.

10 character name

*JOBQPRI2 

Job queue priority

Valid for job descriptions only.

1 (highest) - 9 (lowest)

*JOBQSBS2 

Subsystem that receives jobs from this queue

Valid for job queues only.

Subsystem name

*JOBQSTS2 

Job queue status

Valid for job queues only.

HELD, RELEASED

*JOURNAL5 

Journal attributes

Group which checks *JOURNALED, *JRN, *JRNLIB, *JRNIMG, *JRNOMIT6.

Results are described in Comparison results for journal status and other journal attributes.

*JOURNALED5 

Object is currently journaled

*YES, *NO6 

*JRN5 

Current or last journal

10 character name6

*JRNIMG5 

Record images

*AFTER, *BOTH

*JRNLIB5 

Current or last journal library

10 character name6

*JRNOMIT

Journal entries to be omitted

*OPNCLO, *NONE

*LANGID2 

Language ID

Valid for user profiles only.

*SYSVAL, language-id

*LASTUSED7 

Last used date

Valid for user profiles only.

*BLANK, date (in SAA format YYYY-MM-DD)

*LENGTH

Data area length

Valid for data areas only

1-2000 (character), 1-24 (decimal), 1 (logical)

*LIBEXT

Extended library information attributes

Group which checks *CRTAUT, *CRTOBJAUD

*LIBLIND

Initial library list

Valid for job descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of library list entries and entry list values are equal. The comparison is order dependent.

*LMTCPB

Limit capabilities

Valid for user profiles only.

*PARTIAL, *YES, *NO

*LOGOUTPUT2 

Job log output

Valid for job descriptions only.

*SYSVAL, *JOBLOGSVR, *JOBEND, *PND

*LVLCHK1 2 

Record format level check

Valid for logical files only.

*YES, *NO

*MAINT1 2  >8 

Access path maintenance

Valid for logical files only.

*DLY, *IMMED, *REBLD

*MAXACT 2 

Maximum active jobs

Valid for subsystem descriptions only.

Numeric value, *NOMAX (32,767)

*MAXMBRS1 2 

Maximum members

Valid for logical files only.

*NOMAX, 1 - 32,767

*MAXSTG9 

Maximum allowed storage

Valid for user profiles only. Not compared for QSECOFR or QTCM user profiles.

Numeric value, *NOMAX (9,223,372,036,854,775,807KB for IBM i 7.3 and higher releases)

*MSGQ2 

Message queue

Valid for user profiles only.

Message queue - message queue name

Library - *LIBL, library name

*NBRMBR1 2

Number of logical file members

Valid for logical files only.

0 - 32,767

*NWSUSRA

Network server user attribute

Valid for user profiles only.

No value, indicator only3 

*OBJATR

Object attribute

10 character object extended attribute

*OBJCTLLVL2 

Object control level

Valid for object types that support this attribute10.

8 character user-defined value

*OPRCTL2 

Operator controlled

Valid for job queues only.

*YES, *NO

*OUTQ2 

Output queue

Valid for job descriptions only.

*USRPRF, *DEV, *WRKSTN, output queue name

*OUTQLIB2 

Output queue library

Valid for job descriptions only.

10 character name

*OUTQPRI2 

Output queue priority

Valid for job descriptions only.

1 (highest) - 9 (lowest)

*OWNER

Object owner

10 character name

*PGP

Primary group

*NONE, user profile name

*PRESTIND

Pre-start job entries

Valid for subsystem descriptions only.

No value, indicator only1 

When this attribute is returned in output, its Difference Indicator value indicates if the number of prestart jobs, program, user profile, start job, wait for job, initial jobs, maximum jobs, additional jobs, threshold, maximum users, job name, job description, first and second class, and number of first and second class jobs values are equal.

*PRFOUTQ2 

Output queue

Valid for user profiles only.

*LIBL/*WRKSTN, *DEV

*PRFPWDIND

User profile password indicator

See Comparison results for user profile password (*PRFPWDIND) for details.

*PRTDEV2 

Printer device

Valid for job descriptions only.

*USRPRF, *SYSVAL, *WRKSTN, printer device name

*PRVAUTIND

Private authority indicator

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of private authorities and private authority values are equal

*PUBAUTIND

Public authority indicator

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the public authority values are equal.

*PWDEXPITV

Password expiration interval

Valid for user profiles only.

*SYSVAL, *NOMAX, 1-366 days

*PWDIND

No password indicator

Valid for user profiles only.

*YES (no password), *NO (password)

*QUEALCIND

Job queue allocation indicator

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the job queue entries for a subsystem are in the same order and have the same queue names and queue library names. It also compares the allocation indicator values

*RLOCIND

Remote location entries

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of remote location entries, remote location, mode, job description and library, maximum active jabs, and default user entry values are equal.

*RTGEIND

Routing entries

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the number of routing entries, sequence number, maximum active, steps, compare start, entry program, class, and compare entry values are equal

*SBSDEXT

Subsystem description extended attributes

Group which checks *AJEIND, *COMMEIND, *JOBQEIND, *MAXACT, *PRESTIND, *RLOCIND, *RTGEIND, *SBSDSTS, *STGPOOL12, *WSENAMIND, *WSETYPIND.11  

*SBSDSTS2 

Subsystem status

Valid for subsystem descriptions only.

*ACTIVE, *INACTIVE

*SIZE

Object size

Numeric value

The value *EC is returned for *DTAQ objects with differences that were identified by configuration that specify to omit content of *DTAQ objects.

*SPCAUTIND

Special authorities

Valid for user profiles only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if special authority values are equal

*SPLATRIND

Spooled file attributes

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if attribute values for spooled files are equal.

*SQLNAME

SQL schema long name

Valid for libraries only.

Up to the first 50 characters of the SQL schema long name.

*SQLSP

SQL stored procedures

Valid for programs and service programs only.

*NONE, or indicator only3 

*NONE is returned when there are no stored procedures associated with the program or service program.

When the indicator only is returned in output, the Difference Indicator value identifies whether SQL stored procedures associated with the object are equal.

*SQLUDF

SQL user defined functions

Valid for programs and service programs only.

*NONE, or indicator only3 

*NONE is returned when there are no user defined functions associated with the program or service program.

When the indicator only is returned in output, the Difference Indicator value identifies whether SQL user defined functions associated with the object are equal.

*STGPOOL12

Storage pools indicator

Valid for subsystem descriptions only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if the storage pools and their attributes are equal.

*SUPGRPIND

Supplemental Groups

Valid for user profiles only.

No value, indicator only3 

When this attribute is returned in output, its Difference Indicator value indicates if supplemental group values are equal

*TEXT2 

Text description

50 character description

*TYPSPFIND

Object type-specific attributes indicator

Valid only for object types: *COSD, *CTLD, *DEVD, *JOBD, *LIB5, *LIND, *MODD, *NTBD, *NWID, *NWSD, *OUTQ, *PGM, *SBSD,*USRPRF.

No value, indicator only3

*TYPE

Data area type - data area types of DDM resolved to actual data area types

Valid for data areas only.

*CHAR, *DEC, *LGL

*UID

User profile ID number

Valid for user profiles only.

1 - 4294967294

*USRATR2 

User-defined attribute

10 character user-defined value

*USRCLS

User Class

Valid for user profiles only.

*SECOFR, *SECADM, *PGMR, *SYSOPR, *USER

*USREXPDAT

User expiration date

Valid for user profiles only.

Date (in job format of the job running CMPOBJA), *NONE, *USREXPITV

*USREXPITV

User expiration interval

Valid for user profiles only.

1-366 when the user profile specifies USREXPDATE(*USREXPITV), otherwise 0 is returned.

*USRPRFEXT

User profile extended attributes

Group which checks *ATTNPGM, *CCSID, *CNTRYID, *CRTOBJOWN, *CURLIB, *GRPAUT, *GRPAUTTYP, *GRPPRF, *INLMNU, *INLPGM, *JOBD, *LANGID, *LASTUSED, *LMTCPB, *MAXSTG *MSGQ, *PRFOUTQ, *PWDEXPITV, *PWDIND, *SPCAUTIND, *SUPGRPIND, *USRCLS, *USREXPDAT, *USREXPITV.

*USRPRFSTS

User profile status

*ENABLED, *DISABLED13

For details, see Comparison results for user profile status (*USRPRFSTS).

*VALUE2 

Data area value

Valid for data areas only.

Character value of data

The value *EC is returned for *DTAARA objects that were identified by configuration that specify to omit content of *DTAARA objects.

*WSENAMIND11 

Workstation entries (name)

Valid for subsystem descriptions only.

No value, indicator only

When this attribute is returned in output, its Difference Indicator value indicates that the number, names, job description, and maximum active jobs values for workstation entries are equal.

*WSETYPIND11

Workstation entries (type)

Valid for subsystem descriptions only

No value, indicator only

When this attribute is returned in output, its Difference Indicator value indicates that the number, type, job description, and maximum active jobs values for workstation entries are equal.

1This attribute only applies to logical files. Use the Compare File Attributes (CMPFILA) command to compare or omit physical file attributes.

2Differences detected for this attribute are marked as *EC (equal configuration) when the compare request specified a data group and the object is configured for system journal replication with a configured object auditing value of *NONE.

3If *PRINT is specified for the output format on the compare request, an indicator appears in the System 1 and System 2 columns. If *OUTFILE is specified, these values are blank.

4A more thorough check of this attribute is performed for *QRYDFN object types when the IBM i release is the same on both systems.

5This attribute is only supported for *LIB object type when the library object is replicated as part of a journal-centric con­figuration.

6These attributes are compared for object types of *FILE, *DTAQ, *DTAARA, and *LIB. These are the only objects sup­ported by IBM's user journals. Objects of type *LIB are only evaluated when the data group specifies object type *LIB for the journal-centric configuration (JRNCENTRIC parameter).

7The *LASTUSED attribute is s supported on instances running MIMIX™ Software version 9.0.06.00 or higher. For details about what date can be set on the target node and the possible difference indicator values that can be returned, see Replicating user profiles and associated message queues.

8Differences detected for this attribute are marked *EC (equal configuration) when the source is set to *IMMED and the target is set to *DLY by Access Path Maintenance.

9On systems running IBM i 7.3 or higher, the MAXSTGLRG field supports a larger value than the MAXSTG field. When comparing attributes between a system that supports only MAXSTG and a system that supports both MAXSTG and MAXSTGLRG, the numeric values are compared directly unless the MAXSTGLRG value is greater than the maximum supported value for MAXSTG on the system running an earlier release. When the MAXSTGLRG value is greater, the MAXSTG value on the other system must be *NOMAX for the attribute to be marked as equal (*EC).

10The *OBJCTLLVL attribute is only supported on the following object types: *AUTL, *CNNL, *COSD, *CTLD, *DEVD, *DTAARA, *DTAQ, *FILE, *IPXD, *LIB, *LIND, *MODD, *NTBD, *NWID, *NWSD, and *USRPRF.

11Workstation entries (*WSENAMIND, *WSETYPIND) can be compared on instances running service pack 8.1.08.00 or higher.

12Storage pools indicator (*STGPOOL) can be compared on instances running service pack 8.1.09.00 or higher. A com­mand request that specifies attribute *ASPNBR shows the results for *STGPOOL instead.

13The profile status is only compared if no data group is specified or the USRPRFSTS has a value of *SRC for the spec­ified data group. If a data group is specified on the CMPOBJA command and the USRPRFSTS value on the object entry has a value of *TGT, *ENABLED, or *DISABLED, the user profile status is not compared.