3.4.3 Starting and stopping services

This section describes how to start and stop the JP1/AJS3 - Print Option Manager License service.

The JP1/AJS3 - Print Option Manager License service receives the collection request for job operation information from JP1/AJS3 - View and collects job operation information.

Organization of this subsection

(1) In Windows
(2) In UNIX

(1) In Windows

When JP1/AJS3 - Print Option Manager License is installed on a Windows host, you can start and stop the JP1/AJS3 - Print Option Manager License service by choosing Services in the Windows Control Panel, or by choosing Administrative Tools and then Services.

Furthermore, you can start and stop the service by executing the net start JP1_AJS2_POML and net stop JP1_AJS2_POML commands.

JP1/AJS3 - Print Option Manager License provides the following service:

Table 3‒4: Service provided by JP1/AJS3 - Print Option Manager License
Service name	Description	Startup type	Account
JP1/AJS3 POML	Collects information about job activity in response to requests received from JP1/AJS3 - View.	Automatic	System

Notes:

If you set the JP1/AJS3 environment setting parameter ADMACLIMIT to yes, and then collect job operation information from JP1/AJS3 - View, implement either of the following depending on the account that is operating the JP1/AJS3 - Print Option Manager License service.

If you are operating the JP1/AJS3 - Print Option Manager License service using a local system account (The default account after installation is set to local system account.):

Create a JP1 user named system and set the JP1 permission level for the JP1 resource group of the target units for the ajsprint command and the ajsshow command.
If you are operating the JP1/AJS3 - Print Option Manager License service using a user account:

Create a JP1 user with the same name as the user account and set the JP1 permission level for the JP1 resource group of the target units for the ajsprint command and the ajsshow command.

For details about the JP1 permission levels that are required to execute the ajsprint command and the ajsshow command, see the documentation for JP1/AJS3.

If you are operating the JP1/AJS3 - Print Option Manager License service using a user account, set the service logon account using the procedure described below.

You need Administrator permission to set a service logon account.

From the Windows Start menu, select Administrative Tools, then Services to display the Services window.
Select JP1/AJS3 POML and then from the menu bar, select Action, and then Properties to display the JP1/AJS3 POML Properties window.
On the Log On tab, select This account to activate the Browse button.
In the This account box, input the account name^# you use to execute the service.

You can input the account name from the dialog box displayed when you click the Browse button.
Input the password in the Password and Confirm password boxes, and then click the OK button.

#

Set an account with the following permissions for the service execution account name:

Administrators permission
Allow log on locally
Log on as a service
Replace a process level token
Adjust memory quota for a process

To Page Top

(2) In UNIX

The following describes how to configure the JP1/AJS3 - Print Option Manager License service to start and stop automatically on a UNIX host.

Notes:

If starting the JP1/AJS3 - POML service (daemon) automatically:

If you have set the JP1/AJS3 - POML service to automatically start up when the OS starts up, create a JP1 user named root and set the JP1 permission level for the JP1 resource group of the target units for the ajsprint command and the ajsshow command.
If starting the JP1/AJS3 - POML service using the jprpomlstart command:

After you log in to the OS, as a user that has superuser permission, execute the jprpomlstart command and start the JP1/AJS3 - POML service, and then create a JP1 user named root and set the JP1 permission level for the JP1 resource group of the target units for the ajsprint command and the ajsshow command.

For details about the JP1 permission levels that are required to execute the ajsprint command and the ajsshow command, see the documentation for JP1/AJS3.

(a) Configuring the JP1/AJS3 - POML service to start automatically

To configure the JP1/AJS3 - POML service (daemon) to start automatically when the system starts:

Stop the JP1/AJS3 - POML service.

Execute the following command to stop all processes of the JP1/AJS3 - POML service.
```
/opt/jp1ajs2pom/bin/jprpomlstop
```
Open the following file in an editor such as vi.
```
/etc/opt/jp1ajs2pom/jprpoml_start
```
Delete the underlined part of the following line from the file (automatic startup shell script).
```
:# /opt/jp1ajs2pom/bin/jprpomlstart >/dev/null 2>/dev/null
```
Check that the line is specified correctly before deleting these characters.
If needed, change the value of the LANG environment variable in the file (automatic startup shell script).
```
LANG=XXXXXX
```
The value of XXXXXX depends on your operating system.

Specify the encoding used by JP1/AJS2 - Manager and JP1/AJS3 - Manager.

If your OS is AIX, you also need to perform steps 5 and 6.

Configure the service to start automatically.

Use the mkitab command to add a startup entry for the JP1/AJS3 - POML service to the /etc/inittab file.

mkitab -i jp1ajs2 " jp1ajs2pom:2:wait:/etc/opt/jp1ajs2pom/jprpoml_start"

Use the lsitab command to check the setting:

lsitab -a

Make sure that a startup entry for the JP1/AJS3 - POML service appears in the file after those for JP1/AJS2 - Manager and JP1/AJS3 - Manager.

init:2:initdefault:
brc::sysinit:/sbin/rc.boot 3 >/dev/console 2>&1 # Phase 3 of system boot
    :
    :
hntr2mon:2:once:/opt/hitachi/HNTRLib2/etc/D002start
jp1base:2:wait:/etc/opt/jp1base/jbs_start
jp1ajs2:2:wait:/etc/opt/jp1ajs2/jajs_start
jp1ajs2pom:2:wait:/etc/opt/jp1ajs2pom/jprpoml_start

Configure the service to stop automatically.

Open the /etc/rc.shutdown script in a text editor, and add the following entry:
```
test -x /etc/opt/jp1ajs2pom/jprpoml_stop && /etc/opt/jp1ajs2pom/jprpoml_stop
```
To avoid errors when automatic shutdown occurs, enter the following as the last line of the script:
```
exit 0
```

Note:: In the LANG environment variable in the automatic startup or automatic shutdown script, specify the character encoding used by JP1/AJS2 - Manager and JP1/AJS3 - Manager. For details on the character encodings you can use, see About the LANG environment variable under List of commands in 8. Commands.
Supplementary note:: You can start the JP1/AJS3 - POML service (daemon) manually by executing the jprpomlstart command. For details on the jprpomlstart command, see jprpomlstart (UNIX) in 8. Commands.

(b) Configuring the JP1/AJS3 - POML service to stop automatically

To configure the JP1/AJS3 - POML service (daemon) to stop automatically when the system shuts down:

Stop the JP1/AJS3 - POML service.

Execute the following command to stop all processes of the JP1/AJS3 - POML service.
```
/opt/jp1ajs2pom/bin/jprpomlstop
```
Open the following file in an editor such as vi.
```
/etc/opt/jp1ajs2pom/jprpoml_stop
```
Delete the underlined part of the following line from the file (automatic shutdown shell script).
```
:# /opt/jp1ajs2pom/bin/jprpomlstop >/dev/null 2>/dev/null
```
Check that the line is specified correctly before deleting these characters.

Supplementary note:: You can stop the JP1/AJS3 - POML service (daemon) manually by executing the jprpomlstop command. For details on the jprpomlstop command, see jprpomlstop (UNIX) in 8. Commands.

To Page Top