Code mapping file (jp1imss_itemedit_codemap.conf)

Organization of this page

Description
Format
File names
Storage folder
When the definition is applied
What is described
Notes
Definition example

Description

This definition file associates a selection code and status specified by using the jssitemedit command with Item elements to be displayed in a window. Do not edit this file because it is associated with selectable Item elements defined by default.

If you customize an Item element or a status name, create a new file for the customization.

Note that when you create a new code mapping file, specify the file name described below within 255 bytes in the absolute path.

To Page Top

Format

;comment
[SEVERITY]
Emergency=1
  :
[IMPACT]
Small=1
  :
[PRIORITY]
Standard=1
  :
[ITEMCATEGORY]
Inquiry=1
  :
[ISSUECATEGORY]
Application=1
  :

Lines starting with a semicolon (;) are treated as comments.

To Page Top

File names

jp1imss_itemedit_codemap.conf (Code mapping file)
jjp1imss_itemedit_codemap.conf.model (Model code mapping file)^#

#

You can use the model file to reset the contents of the code mapping file. To do so, delete the existing code mapping file, then copy and rename the model file.

To Page Top

Storage folder

IM-SS-path\conf\command\

To Page Top

When the definition is applied

The definition is applied to JP1/IM - Service Support when you execute the jssitemedit command.

To Page Top

What is described

The following is the format of the code mapping file:

[Section]
Key=value
Key=value
  :

For Section, specify a name indicating the applicable Item element. This is the name defined in the code mapping file. For Key, specify a value you will specify as an option of the jssitemedit command. You can specify a string of half-width or full-width alphanumeric characters for Key. For value, specify the display order of the selection codes that are defined in the Item form definition file.

To use JP1/IM - Service Support with the default Item form, you can use the code mapping file provided with the product as is. The table below lists the sections, keys, and values that can be defined in the file.

If you customize the Item form, you must edit the code mapping file to create a new file for the customized Item form.

Table 12‒25: Sections, keys, and values that can be defined in the code mapping file
Section	Description	Key	Selection code in an Item element	Value
`STATUS`	Section for determining the selection value for the Status Item element	`Received`	`Received`	`JIMSD_STAT_INQUIRY`
		`Close`	`Close`	`JIMSD_STAT_CLOSE`
		`Investigating`	`Investigating`	`JIMSD_STAT_RESEARCH`
		`Planning`	`Planning`	`JIMSD_STAT_PLANNING`
		`Discussing`	`Discussing`	`JIMSD_STAT_DISCUSSING`
		`Acknowledged`	`Acknowledged`	`JIMSD_STAT_APPROVED`
		`Support Requested`	`Support Requested`	`JIMSD_STAT_WAITING`
		`Reviewing`	`Reviewing`	`JIMSD_STAT_REVIEW`
		`Extended status 01` to `Extended status 40`	`Extended status 01` to `Extended status 40`	`JIMSD_STAT_USER01` to `JIMSD_STAT_USER40`
`CAUSE`	Section for determining the selection value for the Cause Item element	`Blank`	(blank)	`0`
		`New software error`	`New software error`	`1`
		`Known software error`	`Known software error`	`2`
		`New hardware error`	`New hardware error`	`3`
		`Known hardware error`	`Known hardware error`	`4`
		`Documentation error`	`Documentation error`	`5`
		`Document missing`	`Document missing`	`6`
		`User error`	`User error`	`7`
		`Specifications`	`Specifications`	`8`
		`Third-party error`	`Third-party error`	`9`
		`Process error`	`Process error`	`10`
		`Customer request`	`Customer request`	`11`
		`Function extension`	`Function extension`	`12`
		`Business requirement`	`Business requirement`	`13`
		`Incident and problem fix`	`Incident and problem fix`	`14`
		`Process improvement`	`Process improvement`	`15`
RESULT	Section for determining the selection value for the Result Item element	`Blank`	(blank)	`0`
		`Completed`	`Completed`	`1`
		`Canceled`	`Canceled`	`2`
		`Not confirmed`	`Not confirmed`	`3`
		`Change completed`	`Change completed`	`4`
		`Known problem`	`Known problem`	`5`
		`Unknown cause`	`Unknown cause`	`6`
		`Succeeded`	`Succeeded`	`7`
		`Failed (planning error)`	`Failed (planning error)`	`8`
		`Failed (human error)`	`Failed (human error)`	`9`
		`Failed (others)`	`Failed (others)`	`10`
`AVOIDANCE`	Section for determining the selection value for the Workaround type Item element	`Blank`	(Blank)	`0`
		`None`	`None`	`1`
		`Not operated`	`Not operated`	`2`
		`Operated in degraded mode`	`Operated in degraded mode`	`3`
		`Restarted`	`Restarted`	`4`
		`File recovered`	`File recovered`	`5`
		`Change rolled back`	`Change rolled back`	`6`
		`Others`	`Others`	`7`
`SOLUTION`	Section for determining the selection value for the Solution category Item element	`Blank`	(Blank)	`0`
		`Knowledge`	`Knowledge`	`1`
		`Document`	`Document`	`2`
		`User solution`	`User solution`	`3`
		`Secondary support`	`Secondary support`	`4`
		`Problem management`	`Problem management`	`5`
		`Third-party investigation`	`Third-party investigation`	`6`
`CHANGESCALE`	Section for determining the selection value for the Scale of change Item element	`Blank`	(Blank)	`0`
		`Small scale`	`Small scale`	`1`
		`Middle scale`	`Middle scale`	`2`
		`Large scale`	`Large scale`	`3`
`RELEASETYPE`	Section for determining the selection value for the Release type Item element	`Blank`	(Blank)	`0`
		`Package release`	`Package release`	`1`
		`Full release`	`Full release`	`2`
		`Delta release`	`Delta release`	`3`
`PHENOMENON`	Section for determining the selection value for the Occurred type Item element	`Blank`	(Blank)	`0`
`SEVERITY`	Section for determining the selection value for the Severity Item element	`Blank`	(Blank)	`0`
		`Emergency`	`Emergency`	`1`
		`Alert`	`Alert`	`2`
		`Critical`	`Critical`	`3`
		`Error`	`Error`	`4`
		`Warning`	`Warning`	`5`
		`Notice`	`Notice`	`6`
		`Information`	`Information`	`7`
		`Debug`	`Debug`	`8`
`IMPACT`	Section for determining the selection value for the Impact level Item element	`Blank`	(Blank)	`0`
		`Small`	`Small`	`1`
		`Middle`	`Middle`	`2`
		`Large`	`Large`	`3`
`PRIORITY`	Section for determining the selection value for the Priority Item element	`Blank`	(Blank)	`0`
		`Standard`	`Standard`	`1`
		`Urgent`	`Urgent`	`2`
		`Very urgent`	`Very urgent`	`3`
`ITEMCATEGORY`	Section for determining the selection value for the Item type Item element	`Blank`	(Blank)	`0`
		`Inquiry`	`Inquiry`	`1`
		`Failure`	`Failure`	`2`
		`Customer request`	`Customer request`	`3`
`ISSUECATEGORY`	Section for determining the selection value for the Problem domain Item element	`Blank`	(Blank)	`0`
		`Application`	`Application`	`1`
		`Middleware`	`Middleware`	`2`
		`OS`	`OS`	`3`
		`Hardware`	`Hardware`	`4`
		`Network`	`Network`	`5`
		`Process`	`Process`	`6`
`USERCODE01`	User extended code	`Optional`	`Optional`	`Optional`
`USERCODE02`
`USERCODE03`
`USERCODE04`
`USERCODE05`

To Page Top

Notes

You can use the jssitemedit command to specify a priority code from 0 to 3. If you specify another code in the PRIORITY section, the KNAB28006-E error occurs.
You can specify a total of 48 statuses by using the jssitemedit command including eight default statuses provided by JP1/IM - Service Support, and 40 statuses that can be customized by users. If you specify any other status, the KNAB28006-E error occurs.
The Code mapping file (jp1imss_itemedit_codemap.conf) must be created or edited with a character encoding that is compatible with the system locale of the machine on which JP1/IM - Service Support is installed. You can use one of the following character encodings:
- In a Japanese environment: MS932
- In an English environment: ISO-8859-1
- In a Chinese environment: GB18030

To Page Top

Definition example

The following are the contents of the default code mapping file (jp1imss_itemedit_codemap.conf):

[STATUS]
Received=JIMSD_STAT_INQUIRY
Investigating=JIMSD_STAT_RESEARCH
Planning=JIMSD_STAT_PLANNING
Discussing=JIMSD_STAT_DISCUSSING
Support Requested=JIMSD_STAT_WAITING
Reviewing=JIMSD_STAT_REVIEW
Acknowledged=JIMSD_STAT_APPROVED
Close=JIMSD_STAT_CLOSE
Extended status 01=JIMSD_STAT_USER01
Extended status 02=JIMSD_STAT_USER02
Extended status 03=JIMSD_STAT_USER03
Extended status 04=JIMSD_STAT_USER04
Extended status 05=JIMSD_STAT_USER05
Extended status 06=JIMSD_STAT_USER06
Extended status 07=JIMSD_STAT_USER07
Extended status 08=JIMSD_STAT_USER08
Extended status 09=JIMSD_STAT_USER09
Extended status 10=JIMSD_STAT_USER10
Extended status 11=JIMSD_STAT_USER11
Extended status 12=JIMSD_STAT_USER12
Extended status 13=JIMSD_STAT_USER13
Extended status 14=JIMSD_STAT_USER14
Extended status 15=JIMSD_STAT_USER15
Extended status 16=JIMSD_STAT_USER16
Extended status 17=JIMSD_STAT_USER17
Extended status 18=JIMSD_STAT_USER18
Extended status 19=JIMSD_STAT_USER19
Extended status 20=JIMSD_STAT_USER20
Extended status 21=JIMSD_STAT_USER21
Extended status 22=JIMSD_STAT_USER22
Extended status 23=JIMSD_STAT_USER23
Extended status 24=JIMSD_STAT_USER24
Extended status 25=JIMSD_STAT_USER25
Extended status 26=JIMSD_STAT_USER26
Extended status 27=JIMSD_STAT_USER27
Extended status 28=JIMSD_STAT_USER28
Extended status 29=JIMSD_STAT_USER29
Extended status 30=JIMSD_STAT_USER30
Extended status 31=JIMSD_STAT_USER31
Extended status 32=JIMSD_STAT_USER32
Extended status 33=JIMSD_STAT_USER33
Extended status 34=JIMSD_STAT_USER34
Extended status 35=JIMSD_STAT_USER35
Extended status 36=JIMSD_STAT_USER36
Extended status 37=JIMSD_STAT_USER37
Extended status 38=JIMSD_STAT_USER38
Extended status 39=JIMSD_STAT_USER39
Extended status 40=JIMSD_STAT_USER40
 
[CAUSE]
Blank=0
New software error=1
Known software error=2
New hardware error=3
Known hardware error=4
Documentation error=5
Document missing=6
User error=7
Specifications=8
Third-party error=9
Process error=10
Customer request=11
Function extension=12
Business requirement=13
Incident and problem fix=14
Process improvement=15
 
[RESULT]
Blank=0
Completed=1
Canceled=2
Not confirmed=3
Change completed=4
Known problem=5
Unknown cause=6
Succeeded=7
Failed (planning error)=8
Failed (human error)=9
Failed (others)=10
 
[AVOIDANCE]
Blank=0
None=1
Not operated=2
Operated in degraded mode=3
Restarted=4
File recovered=5
Change rolled back=6
Others=7
 
[SOLUTION]
Blank=0
Knowledge=1
Document=2
User solution=3
Secondary support=4
Problem management=5
Third-party investigation=6
 
[CHANGESCALE]
Blank=0
Small scale=1
Middle scale=2
Large scale=3
 
[RELEASETYPE]
Blank=0
Package release=1
Full release=2
Delta release=3
 
[PHENOMENON]
Blank=0
 
[SEVERITY]
Blank=0
Emergency=1
Alert=2
Critical=3
Error=4
Warning=5
Notice=6
Information=7
Debug=8
 
[IMPACT]
Blank=0
Small=1
Middle=2
Large=3
 
[PRIORITY]
Blank=0
Standard=1
Urgent=2
Very urgent=3
 
[ITEMCATEGORY]
Blank=0
Inquiry=1
Failure=2
Customer request=3
 
[ISSUECATEGORY]
Blank=0
Application=1
Middleware=2
OS=3
Hardware=4
Network=5
Process=6
 
[USERCODE01]
 
[USERCODE02]
 
[USERCODE03]
 
[USERCODE04]
 
[USERCODE05]

To Page Top