Preface
This manual explains how to use JP1/Advanced Shell to create and execute job definition scripts for batch jobs.
-
JP1/Advanced Shell (script execution base for batch jobs)
-
JP1/Advanced Shell - Developer (script development base for batch jobs)
This manual uses the terms "execution environment" and "development environment" to distinguish between the environment in which JP1/Advanced Shell is installed and the environment in which JP1/Advanced Shell - Developer environment is installed, respectively.
- Organization of this preface
■ Relevant program products
-
P-1M12-B1BL JP1/Advanced Shell 11-10 (for AIX V6.1, AIX V7.1, AIX V7.2)
-
P-8112-B1BL JP1/Advanced Shell 11-10 (for Red Hat Enterprise Linux Server 6 (64-bit x86_64), Red Hat Enterprise Linux Server 7 (64-bit x86_64), Oracle Linux 6 (x64), Oracle Linux 7, CentOS 6, CentOS 7, SUSE Linux 12)
-
P-1J12-B1BL JP1/Advanced Shell 11-10 (for HP-UX 11i V3 (IPF))
-
P-9D12-B1BL JP1/Advanced Shell 11-10 (for Solaris 10 (SPARC), Solaris 11 (SPARC))
-
P-2A12-B1BL JP1/Advanced Shell 11-10 (for Windows Server 2016, Windows 10, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008)
-
P-2A12-B2BL JP1/Advanced Shell - Developer 11-10 (for Windows Server 2016, Windows 10, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008)
■ Intended readers
This manual is intended for those interested in using JP1/Advanced Shell to develop, execute, and/or manage batch jobs. This manual provides explanations assuming readers are familiar with the following:
Windows and UNIX
JP1/AJS
JP1/Base
JP1/IM
■ Organization of this manual
This manual consists of the following chapters and appendixes.
This manual is common to the OS of both Windows and UNIX. If there are differences between each OS, such differences are separately described within the text.
- PART 1: Overview
-
- 1. Overview of JP1/Advanced Shell
-
JP1/Advanced Shell is a product for creating and executing job definition scripts for batch jobs. Chapter 1 describes the purpose of JP1/Advanced Shell, provides an example of its application to a business operation, explains the overall system configuration and general procedures, and provides an overview of JP1/Advanced Shell's operation and functionality in a cluster system.
- PART 2: Setup
-
- 2. Preparations for Using JP1/Advanced Shell
-
Chapter 2 discusses the conditions and requirements for using JP1/Advanced Shell, including the program installation directory, the main programs, prerequisites, installation, environment information settings, custom job registration, user-reply functionality settings, and environment information settings for cluster operation.
- PART 3: Operation
-
- 3. Executing Batch Jobs
-
Chapter 3 explains how to execute batch jobs and the batch job processing in JP1/Advanced Shell (execution environment).
- 4. Using JP1/Advanced Shell - Developer (Windows Only)
-
Chapter 4 explains how to employ JP1/Advanced Shell - Developer so that you can use JP1/Advanced Shell Editor to develop job description scripts in a Windows environment. The chapter also explains how to use the editor to debug job definition script files.
- 5. Creating Job Definition Scripts
-
Chapter 5 explains the syntax for job definition scripts.
- 6. Debugging Job Definition Scripts
-
Chapter 6 describes the debugger functions of JP1/Advanced Shell.
- PART 4: Reference
-
- 7. Parameters Specified in the Environment Files
-
Chapter 7 provides details about the description format used for parameters and commands. You define in environment files information such as return codes, coverage, system execution logs, and directory paths. Export parameters are used to define environment variables. Conditional parameters are used to apply desired environment setting parameters or export parameters specifically to the physical host or specifically to a particular logical host.
- 8. Commands Used During Operations
-
Chapter 8 describes the syntax and details of the commands used for operations.
- 9. Job Definition Script Commands and Control Statements
-
Chapter 9 describes in detail the description formats for the standard shell commands, extended shell commands, extended script commands, script control statements, and reserved script commands used in job definition scripts.
- 10. Script development parts
-
Chapter 10 explains the description formats and details of the script development parts.
- PART 5: Troubleshooting
-
- 11. Troubleshooting
-
Chapter 11 describes troubleshooting, including how to respond when problems occur, the types of log information, the troubleshooting information that needs to be collected, and how to collect it.
- 12. Messages
-
Chapter 12 lists the messages output by JP1/Advanced Shell and provides detailed information about errors that might occur.
- A. Coverage Information That Is Acquired
-
Appendix A describes the coverage information that JP1/Advanced Shell acquires.
- B. If you start from the job scheduler other than JP1/AJS (only for UNIX)
-
Appendix B explains how to start the batch job of JP1/Advanced Shell by using the job scheduler other than JP1/AJS in the execution environment.
- C. Modifications Made in Each Version
-
Appendix C lists the modifications made in each version.
- D. Glossary
-
Appendix D is a glossary that explains the terms used in this manual.
■ Conventions: Fonts and symbols
The following table explains the text formatting conventions used in this manual:
Text formatting |
Convention |
---|---|
Bold |
Bold characters indicate text in a window, other than the window title. Such text includes menus, menu options, buttons, radio box options, or explanatory labels. For example:
|
Italic |
Italic characters indicate a placeholder for some actual text to be provided by the user or system. For example:
Italic characters are also used for emphasis. For example:
|
Monospace |
Monospace characters indicate text that the user enters without change, or text (such as messages) output by the system. For example:
|
underline |
The underline indicates the default value among two or more values enclosed in selection symbols. |
The following table explains the symbols used by this manual in syntax explanations:
Symbol |
Convention |
---|---|
| |
A vertical bar separates multiple items, and has the meaning of OR. For example: A|B|C means A, or B, or C. |
{ } |
Curly brackets indicate that only one of the enclosed items is to be selected. For example: {A|B|C} means only one of A, or B, or C. |
[ ] |
Square brackets indicate that the enclosed item or items are optional. A vertical bar is used to delimit multiple items. For example:
|
< > |
Single angle brackets enclose the syntax element that must be used to specify an item. |
+ |
The plus sign indicates that the immediately preceding item can be specified multiple times. It is also used to indicate that the items before and after it are specified together.
|
* |
The asterisk indicates that the immediately preceding item can be omitted or that it can be specified one or more times.
|
~ |
A swung dash indicates that the syntax element enclosed by the single angle brackets (< >), double angle brackets (<< >>), or double parentheses ((( ))) that follow must be used to specify the item that precedes the swung dash. |
<< >> |
Double angle brackets enclose the default value for an item. |
(( )) |
Double parentheses enclose the permissible range of values that can be specified. |
... |
An ellipsis indicates that the immediately preceding item can be repeated as many times as necessary. For example: A, B, B, ... means that, after you specify A, B, you can specify B as many times as necessary. |
Denotes a single-byte space.
|
The following table explains the syntax elements used in this manual:
Syntax element |
Characters that can be specified |
---|---|
<numeric characters> |
0|1|2|3|4|5|6|7|8|9 |
<uppercase alphabetic characters> |
A|B|C|...|Z |
<lowercase alphabetic characters> |
a|b|c|...|z |
<alphabetic characters> |
<uppercase alphabetic characters>|<lowercase alphabetic characters> |
<special characters> |
,|.|/|'|(|)|*|&|+|-|=| |
<octal> |
<0|1|2|3|4|5|6|7> + |
<decimal> |
<numeric characters> + |
<hexadecimal> |
0|1|2|3|4|5|6|7|8|9|A|B|C|D|E|F |
<integer> |
A series of signed or unsigned numeric characters |
<unsigned integer> |
<numeric characters> + |
ss<symbolic name> |
{<alphabetic characters>|<numeric characters>|@|#|_ (underscore)} + Used in: Job names |
<environment variable name> |
{<alphabetic characters>|_ (underscore)}{<alphabetic characters>|_ (underscore)}|<numeric characters)} * Used in: Environment variable file definition names, environment variable names, and extended script commands |
<path name> |
A character string that conforms to the path naming conventions of UNIX or Windows |
<command name> |
A path name consisting of permitted characters other than the path separator |
<logical host name> |
{<alphabetic characters>|<numeric characters>|- (hyphen)} + |
<any character string> |
A string of characters consisting of any combination of alphabetic characters. Note the following:
|
<ASCII character string> |
A character string consisting exclusively of characters in the ASCII character set, other than ASCII control characters (a character string in the range from 0x20 to 0x7E) |
■ Conventions: Abbreviations
Abbreviations for product names
This manual uses the following abbreviations for product names:
Abbreviation |
Full name or meaning |
||
---|---|---|---|
JP1/Advanced Shell |
JP1/Advanced Shell |
||
JP1/Advanced Shell - Developer |
|||
JP1/AJS |
JP1/AJS3 |
JP1/Automatic Job Management System 3 - Agent |
|
JP1/Automatic Job Management System 3 - Manager |
|||
JP1/Automatic Job Management System 3 - View |
|||
JP1/AJS - Agent |
JP1/AJS3 - Agent |
JP1/Automatic Job Management System 3 - Agent |
|
JP1/AJS - Definition Assistant |
JP1/AJS3 - Definition Assistant |
JP1/Automatic Job Management System 3 - Definition Assistant |
|
JP1/AJS - Manager |
JP1/AJS3 - Manager |
JP1/Automatic Job Management System 3 - Manager |
|
JP1/AJS - View |
JP1/AJS3 - View |
JP1/Automatic Job Management System 3 - View |
|
JP1/IM |
JP1/IM - Manager |
JP1/Integrated Management - Manager |
|
JP1/IM - View |
JP1/Integrated Management - View |
||
UNIX |
Linux |
CentOS 6 |
CentOS 6 |
CentOS 7 |
CentOS 7 |
||
Oracle Linux 6 |
Oracle Linux® Operating System 6 (x64) |
||
Oracle Linux 7 |
Oracle Linux® Operating System 7 |
||
RHEL 6 |
Red Hat Enterprise Linux® Server 6 (64-bit x86_64) |
||
RHEL 7 |
Red Hat Enterprise Linux® Server 7 (64-bit x86_64) |
||
SUSE Linux 12 |
SUSE Linux® Enterprise Server 12 |
||
AIX |
AIX V6.1 |
||
AIX V7.1 |
|||
AIX V7.2 |
|||
HP-UX |
HP-UX 11i V3 (IPF) |
||
Solaris |
Solaris 10 (SPARC) |
||
Solaris 11 (SPARC) |
Abbreviations for Microsoft product name
This manual uses the following abbreviations for Microsoft product names:
Full name or meaning |
Abbreviation |
|
---|---|---|
Microsoft® Windows Server® 2016 Standard |
Windows Server 2016 |
Windows Server# |
Microsoft® Windows Server® 2016 Datacenter |
||
Microsoft® Windows Server® 2012 Standard |
Windows Server 2012 |
|
Microsoft® Windows Server® 2012 Datacenter |
||
Microsoft® Windows Server® 2012 R2 Standard |
||
Microsoft® Windows Server® 2012 R2 Datacenter |
||
Microsoft® Windows Server® 2008 R2 Datacenter |
Windows Server 2008 |
|
Microsoft® Windows Server® 2008 R2 Enterprise |
||
Microsoft® Windows Server® 2008 R2 Standard |
||
Windows® 10 Home 32-bit version |
Windows 10 |
Windows# |
Windows® 10 Pro 32-bit version |
||
Windows® 10 Enterprise 32-bit version |
||
Windows® 10 Home 64-bit version |
||
Windows® 10 Pro 64-bit version |
||
Windows® 10 Enterprise 64-bit version |
||
Windows® 8.1 32-bit version |
Windows 8 |
|
Windows® 8.1 Pro 32-bit version |
||
Windows® 8.1 Enterprise 32-bit version |
||
Windows® 8.1 64-bit version |
||
Windows® 8.1 Pro 64-bit version |
||
Windows® 8.1 Enterprise 64-bit version |
||
Windows® 8 32-bit version |
||
Windows® 8 Pro 32-bit version |
||
Windows® 8 Enterprise 32-bit version |
||
Windows® 8 64-bit version |
||
Windows® 8 Pro 64-bit version |
||
Windows® 8 Enterprise 64-bit version |
||
Microsoft® Windows® 7 Enterprise |
Windows 7 |
|
Microsoft® Windows® 7 Professional |
||
Microsoft® Windows® 7 Ultimate |
||
Microsoft® Excel |
Excel |
|
Microsoft® Office Excel |
#: Windows Server and Windows are sometimes referred to collectively as Windows.
■ Conventions: Directory names
This manual uses the term directory wherever possible as a generic term for what Windows calls a folder and UNIX calls a directory.
In connection with this convention, this manual uses / as the directory delimiter. In Windows-specific cases, \ is used as the folder delimiter.
■ Conventions: The JP1/Advanced Shell installation folder in Windows
In this manual, installation folder refers to the folder in which JP1/Advanced Shell has been installed, unless otherwise stated. The following shows the installation folder when the product is installed with the default settings.
- x86 environment:
system-drive:\Program Files\Hitachi\JP1AS
- x64 environment:
system-drive:\Program Files(x86)\Hitachi\JP1AS
■ Conventions: Administrators permissions
This manual uses the term Administrators permissions to refer to the Administrators permissions for a local PC. The actions of a user who has Administrators permissions for a local PC are no different from those for a local user or domain user, or for a user working in an Active Directory environment.
■ Conventions: Common application data folder
The following shows the common application data folder used in this manual.
system drive:\ProgramData
■ Conventions: Shared documents folder
The following shows the shared documents folder used in this manual.
system drive:\Users\Public\Documents
■ Conventions: Windows menu names used in the manual
The Windows menu names used in this manual assume that you are using one of the following OSs:
Windows 7, Windows Server 2008
In Windows Server 2016, Windows 10, Windows 8, or Windows Server 2012, no Start menu is displayed. Instead, you must use the Start window, which can be opened from the lower left corner of the window.
■ Conventions: KB, MB, GB, and TB
This manual uses the following conventions:
1 KB (kilobyte) is 1,024 bytes.
1 MB (megabyte) is 1,0242 bytes
1 GB (gigabyte) is 1,0243 bytes.
1 TB (terabyte) is 1,0244 bytes.
■ Related publications
This manual is part of a related set of manuals. The manuals in the set are listed below (with the manual numbers):
- Guides related to JP1/Advanced Shell
-
-
JP1 Version 11 Job Management: Getting Started (Scripting Language) (3021-3-B31(E))
-
- JP1/AJS
-
JP1 Version 11 Job Management: Getting Started (Job Scheduler) (3021-3-B11(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 System Design (Configuration) Guide (3021-3-B13(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 Configuration Guide (3021-3-B15(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 Troubleshooting (3021-3-B17(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 Operator's Guide (3021-3-B18(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 Command Reference (3021-3-B19(E))
-
JP1 Version 11 JP1/Automatic Job Management System 3 - Definition Assistant Description, Operator's Guide and Reference (3021-3-B25(E))
-
- Job Management Partner 1/Software Distribution
-
-
Job Management Partner 1 Version 9 Job Management Partner 1/Software Distribution Description and Planning Guide (3020-3-S79(E)), for Windows systems
-
Job Management Partner 1 Version 9 Job Management Partner 1/Software Distribution Administrator's Guide Volume 1 (3020-3-S81(E)), for Windows systems
-
Job Management Partner 1 Version 8 Job Management Partner 1/Software Distribution SubManager (3020-3-L42(E)), for UNIX systems
-
- JP1/Base
-
-
JP1 Version 11 JP1/Base User's Guide (3021-3-A01(E))
-
- JP1/IM
-
-
JP1 Version 11 JP1/Integrated Management - Manager Configuration Guide (3021-3-A08(E))
-
JP1 Version 11 JP1/Integrated Management - Manager Administration Guide (3021-3-A09(E))
-
- uCosminexus Application Server
-
-
uCosminexus Application Server Expansion Guide (3020-3-Y08(E))
-
uCosminexus Application Server Command Reference Guide (3020-3-Y15(E))
-