Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference
Format
DESC_VERSION=file-version [DisplayItemContainer] : [DisplayItemInformation] ValidTab=All Visible=whether-visible AttrName=JP1-event-attribute-name AttrOrder=sort-order ColumnSize=column-width [End] [End] :
File
defaultUser (default user profile)
defaultUser.model (model file for the default user profile)
profile_user-name (user profile for an individual JP1 user)
Storage directory
- In Windows
- Console-path\conf\console\profile\
- shared-folder\jp1cons\conf\console\profile\ (logical host)
- In UNIX
- /etc/opt/jp1cons/conf/console/profile/
- shared-directory/jp1cons/conf/console/profile/ (logical host)
Description
This file defines environment information about how the Event Console window is displayed for each user.
At the manager, there is a user profile for each user. A user profile defines a user environment for the event console (principally, environment information about the window display). A user profile can be created for each user under the name profile_user-name (using the JP1 user's user name). There is also a default profile, defaultUser, that can be used as the default profile for any user. If you edit the defaultUser profile, the new contents become the default profile for user profiles that are created in the future.
You can define profile_user-name in the Preferences window. If there are any errors in the user profile, the Event Console window might not display correctly. For this reason, we recommend that you use the Preferences window of JP1/IM - View to define user profiles.
When the definitions are applied
The definition takes effect when you re-log in to JP1/IM - Manager (JP1/IM - Central Console).
Information that is specified
- DESC_VERSION=file-version
- Specifies the version of the user profile being created. The items that can be specified in [DisplayItemInformation] to [End] depend on the value specified for the file version. For program version 09-00 or later, specify 11 for the file version. If the file version specified is 10 or earlier, do not attempt to change the file version.
- The following operations update all instances of profile_user-name to the most recent file version:
- Saving the Preferences window from JP1/IM - View
- Saving the column width of the items that are displayed in the list of events on a page in the Event Console window during logout from JP1/IM - View
- To set defaultUser (default user profile) to file version 11, overwrite defaultUser with defaultUser.model (model file for the default user profile), and then edit the file.
- [DisplayItemInformation] to [End]
- Specify the attributes of JP1 events that are to be displayed in the Event Console window.
- [DisplayItemInformation] through [End] constitute a single definition block. The contents of this definition block take effect on all three pages of the Event Console window. To add a definition block, insert it between [DisplayItemContainer] and [End].
- The parameters that can be specified in [DisplayItemInformation] through [End] are described below.
- You must not edit the parameters in [DisplayItemInformation] through [End] for a definition block in which AttrOrder=0 is specified, because such definition blocks are used by the system.
- ValidTab = All
- This is a fixed character string that must not be changed.
- Visible = whether-visible
- Specifies whether the information for the attribute specified in AttrName is to be displayed. If you specify true in whether-visible, information about the attribute specified in AttrName is displayed. If false is specified, information about the attribute specified in AttrName is not displayed. When false is specified, the corresponding item is displayed in Available items in the Preferences window. If you specify false, you must specify -1 in AttrOrder.
- AttrName = attribute-name-to-be-displayed
- Specifies the attribute name of the JP1 event. Information about the attribute specified here is displayed in the Event Console window.
- The following table lists the attributes that can be set.
Table 2-17 List of attributes that can be set in attribute-name-to-be-displayed
No. Specifiable attribute name Attribute DESC_VERSION 1-10#1 11 1 IM.EVENT_TYPE Type Y Y 2 B.SEQNO Serial number Y Y 3 B.IDBASE Event ID Y Y 4 B.PROCESSID Source process ID Y Y 5 B.TIME Registered time Y Y 6 B.ARRIVEDTIME Arrived time Y Y 7 B.USERID Source user ID Y Y 8 B.GROUPID Source group ID Y Y 9 B.USERNAME Source user name Y Y 10 B.GROUPNAME Source group name Y Y 11 B.SOURCESERVER Source host Y Y 12 B.SOURCESEQNO Source serial number Y Y 13 B.MESSAGE Message Y Y 14 E.SEVERITY Event level Y Y 15 E.USER_NAME User name Y Y 16 E.PRODUCT_NAME Product name Y Y 17 E.OBJECT_TYPE Object type Y Y 18 E.OBJECT_NAME Object name Y Y 19 E.OBJECT_ID Object ID Y Y 20 E.ROOT_OBJECT_TYPE Root object type Y Y 21 E.ROOT_OBJECT_NAME Root object name Y Y 22 E.OCCURRENCE Occurrence Y Y 23 E.START_TIME Start time Y Y 24 E.END_TIME End time Y Y 25 E.@JP1IM_ACTCONTROL Action N Y 26 E.@JP1IM_ACTTYPE Action type N Y 27 E.@JP1IM_ORIGINAL_SEVERITY Original severity level N Y 28 E.@JP1IM_CHANGE_SEVERITY New severity level N Y 29 E.@JP1IM_MEMO Memo N Y 30 E.ACTION_TARGET#2 Action Y N 31 IM.ACTION_TYPE#2 Action type Y N
- Legend:
- Y: Can be specified
- N: Cannot be specified
- #1
- There are no differences in the items that can be specified for file versions 1 through 10.
- #2
- These items are compatible with version 8. If DESC_VERSION is 10 or earlier (definition for version 8 or earlier), these attributes are converted as follows:
- E.ACTION_TARGET
E.@JP1IM_ACTCONTROL
- IM.ACTION_TYPE
E.@JP1IM_ACTTYPE
- AttrOrder = sort-order
- Specifies the display column location relative to the left margin. If you specify 1, the attribute is displayed as the first (leftmost) item in the list of events. Do not specify the same value for more than one item.
- Do not specify 0 because it is used by the system.
- If there are any errors in the user profile, the Event Console window might not display correctly. For this reason, we recommend that you use the Preferences window of JP1/IM - View to define user profiles.
- ColumnSize = column-width
- Specifies the column width. The permitted value range is from 1 to 1,000.
Notes
- Specify each user profile carefully because the contents of this file affect overall event console operation. Do not change any attribute or attribute value that is not explained here. If such an attribute or attribute value is changed, the event console might not function correctly.
- Because a user profile might be overwritten during JP1/IM - View operation or termination processing, make sure that you terminate JP1/IM - View before editing a user profile.
- There is one user profile for each manager. Therefore, if you have changed the manager for logging in, you must change the profile at the connection destinations.
- When you intend to edit the contents of the defaultUser file, you must make a backup before editing the file.
- Using JP1/Base's user management to delete a user does not delete the user profile for that user.
- If you use JP1/Base's user management to rename a user, the user's existing user profile is not inherited.
- If a user profile contains an error, such as an attribute value outside the permitted range of values, the event console might not function correctly.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.