jsmigr utility: migrates PSF for AIX job scripts in InfoPrint Manager for AIX

Syntax

jsmigr JobScript …

Description

Enter the jsmigr utility to migrate PSF for AIX job scripts to InfoPrint command scripts and attributes files. The jsmigr utility creates these files:
JobScript.ksh
InfoPrint command script containing
  • The pdpr command
  • One or more -X flags invoking attributes files
  • Other flags and arguments of the pdpr command, if the job script includes the corresponding keywords,
This file is created in the same directory as the migrated job script and has the same file name with .ksh appended.
JobScript.X
Attributes file used by JobScript.ksh, containing attributes migrated from the job script keywords. This file is created in the same directory as the migrated job script and has the same file name with .X appended.
FileName.X
Attributes files used by JobScript.ksh. These files are migrated from job scripts named as values for the a_Parmdd, i_Filenames, p_Config, and e_Filemsg keywords. Each file is created in the same directory as the original file and has the same file name with .X appended.
    Note:
  1. This utility normally executes as part of the InfoPrint installation.
  2. Migrating PSF for AIX job script keywords to InfoPrint equivalents shows the attributes to which job script keywords are migrated.
  3. If multiple job scripts refer to the same file, jsmigr migrates the file only once.
  4. Job scripts named as values for the a_Parmdd, p_Config, and e_Filemsg keywords must be specified with absolute path names.
  5. InfoPrint searches for job scripts named as values for the i_Filenames keyword in these directories:
    1. Current directory
    2. $HOME/js
    3. /var/psf/js
  6. If a data type is specified with the JsFileType keyword, keywords that are not valid for that data type are commented out in the attributes file resulting from conversion. For example, if JsFileType has any value other than line, all a_ keywords are commented out. If you edit the attributes file and change the value of the document-format attribute to line-data, you must remove the comment characters before using the attributes file to submit line-data jobs.
  7. Job scripts containing both a_ and p_ keywords might convert to an attributes file that causes transforms to fail, especially if any of the keywords convert to the other-transform-options attribute. This happens because PSF for AIX ignores job script keywords that do not apply to the job, but InfoPrint processes all attributes.
  8. If jsmigr encounters a job script keyword that it cannot map to an InfoPrint attribute, it issues an error message, erases the attributes file it is writing, ends migrating the job script, and continues with the next job script.
  9. If jsmigr encounters a job script keyword that it can map to an InfoPrint attribute, with a value that has no InfoPrint equivalent, it converts the keyword and continues writing the attributes file. When you use the attributes file to submit a job, InfoPrint issues an error message and does not print or send the job.

Argument

The argument value identifies the job script to be migrated.

Valid argument values for the jsmigr utility are:

JobScript
Specifies the job script to be migrated. The job script file must have a .js extension, which you do not have to specify.

You can specify multiple job script names. You can use an asterisk (*) to specify all job scripts in a directory.

Examples

  • To migrate the job scripts bigjob.js and smalljob.js, enter:
    jsmigr bigjob smalljob
  • To migrate all the job scripts in the directory /var/psf/js, enter:
    jsmigr /var/psf/js/*