You are currently on IBM Systems Media’s archival website. Click here to view our new website.


Bookmark and Share
RSS

Recent Posts

IBM i 7.3 Enhancements for Display Job Log (DSPJOBLOG)

June 27, 2016

This week’s blog was written by Mike Russel, who works on the IBM i work management team.  Thanks Mike!

This week, I’m going to share a super-secret enhancement in the 7.3 release.  The Display Job Log (DSPJOBLOG) command was enhanced with two new parameters: MSGF and DUPJOBOPT.

Display Job Log (DSPJOBLOG)                        

Type choices, press Enter.                                                                                                                                 

 Job name . . . . . . . . . . . .   *_________    Name, *                     

   User . . . . . . . . . . . . .     __________  Name                         

   Number . . . . . . . . . . . .     ______      000000-999999               

 Output . . . . . . . . . . . . .   *_______      *, *PRINT, *APIDFN, *OUTFILE

 File to receive output . . . . .   __________    Name                         

   Library  . . . . . . . . . . .     *LIBL_____  Name, *LIBL, *CURLIB        

 Output member options:                                                       

   Member to receive output . . .   *FIRST____    Name, *FIRST                

   Replace or add records . . . .   *REPLACE      *REPLACE, *ADD              

 Message file . . . . . . . . . .   *MSG_         *MSG, *LIBL                                                                                              

                            Additional Parameters                             
                                                                      

 Duplicate job option . . . . . .   *SELECT       *SELECT, *MSG                

                                                                               

                                                                              

Duplicate Job Option (DUPJOBOPT) Parameter

The duplicate job option parameter will allow you to select one job when there are several jobs with the same job name.  It is the same parameter that is on many other job commands.

Message File (MSGF) Parameter

Multiple languages are supported on a single IBM i system with language libraries for each secondary language.  The secondary language library is placed ahead of QSYS in the library list to use the other language.  The secondary language library contains message files with translated operating system message descriptions.

The message file parameter was added to allow users on multilingual systems to view most operating system messages for other jobs in their language.  When messages are formatted for display job log many of the current user's job attributes such as date format and date separator are used.  But prior to release 7.3 the message description used to format the message came from the message file found when the message was sent.  The default value MSGF(*MSG) directs DSPJOBLOG to continue to use the message file found when the message was sent.  The user’s current library list is searched to find the message file when MSGF(*LIBL) is used.

In this example, the system operator is using the QSYS2931 library containing Spanish language objects. 

This is what the system operator is seeing for his job on device WS2931:

 DawnMayImage1.jpg

When we look at his joblog from our job using a primary English language this is how it looks with the different parameters:

> DSPJOBLOG JOB(WS2931) MSGF(*MSG) 
DawnMayImage2.jpg
 

> DSPJOBLOG JOB(WS2931) MSGF(*LIBL)

DawnMayImage3.jpg 

Work with Job option 10 (display job log) will use the current library list to find the message file.



Posted June 27, 2016| Permalink

-->