Starting a Session on UNIX

Method 1: Using the Desktop

1. On CDE desktops (AIX, HP-UX and Sun Solaris), open the Application Manager cabinet on the front panel.

2. Open the CATIA directory.

3. Double-click the CATIA V5R18 icon.

You can also double-click document icons in your file manager to start Version 5. Note, however, that this starts a new Version 5 session each time: the document is not added to a Version 5 session which is already running.

Method 2: From the Command Line Using the catstart Command

This command is used to launch other programs for:

• starting a Version 5 session (for example, CNEXT)
• running Version 5 environment administration tools (catiaenv, setcatenv, delcatenv, lscatenv, chcatenv, readcatenv)
• running Version 5 software management tools (CATSoftwareMgt, CATNodelockMgt, CATOptionsMgt and the equivalent batch commands).

1. Log on as either root or end user.

2. Enter the command:

/usr/DassaultSystemes/B18/OS_a/code/command/catstart -run CNEXT
or:
/usr/DassaultSystemes/B18/OS_a/code/command/catstart

where "OS_a" is:

• aix_a
• hpux_a
• solaris_a

to start a session using the default global environment created at installation.

You can also run the command by changing to the directory:

/usr/DassaultSystemes/B18/OS_a/code/command/

If you do so, run the command like this:

./catstart -run CNEXT
or:
./catstart

• -e: starts Version 5 and passes the name of the command to start
• -batch: used with "-object", this argument runs macros in batch mode (an interactive session is not displayed).
  Used with "-e", it specifies that you want to run a batch utility. For example, you would run a batch utility like this:
  ./catstart -run "CNEXT -batch -e CATV4ToV5Migration"
• -direnv: specifies the directory created at installation containing the environment (which may be different from the default $HOME/CATEnv directory)
• -env: specifies a new environment name (for more information, refer to "Managing Environments"); if you do not specify an environment, the default global environment created at installation is used
• -object: followed by object to load (between " ") when starting a session; for example, the following command runs a session and loads a document:

./catstart -direnv /CATEnv -env CATIA.V5R18.B18 -object "/tmp/Part1.CATPart"

If the program you want to start requires you to specify options, you must enclose the parameters between " " (for example, -object "arg1 arg2"). For example:

./catstart -run CATSoftwareMgt -object "-L"

• -run

  This option is used to launch other programs for:

  • starting a Version 5 session (for example, CNEXT)
  • running Version 5 environment administration tools (catiaenv, setcatenv, delcatenv, lscatenv, chcatenv, readcatenv)
  • running Version 5 software management tools (CATSoftwareMgt, CATNodelockMgt, CATOptionsMgt and the equivalent batch commands).

The "-run" option is followed by the name of the program to start. If this option is not specified, a CATIA session is started by default.

These commands also have their own options. If the program you want to start requires you to specify options, you must enclose the program name and the parameters between " ". For example, the following command:

./catstart -direnv /CATEnv -env CATIA.V5R18.B18 -run "CATSoftwareMgt -L"

lists the installed configurations and/or products on your workstation.

• -s: non-verbose mode
• -h: displays help
• -remote: remote environment
• -user: user environment

Exporting the runtime variables of the default global environment in the current window

1. Log on as either root or end user.

2. Enter the command:

/usr/DassaultSystemes/B18/OS_a/code/command/catstart -run ksh

which exports the runtime variables of the default global environment in the current window.

3. Run the command, for example:

CATSoftwareMgt

Method 3: Running Macros Using the catstart Command

1. Log on as either root or end user.

2. Go to the directory:

/usr/DassaultSystemes/B18/OS_a/code/command

where "OS_a" is:

• aix_a
• hpux_a
• solaris_a.

3. Start a Version 5 session and run a macro automatically by running a command like this:

./catstart -run CNEXT -object "-macro /tmp/Mymacro.CATScript"

./catstart -run CNEXT -object "-batch -macro /tmp/Mymacro.CATScript"

./catstart -run "CNEXT -batch -macro /tmp/Mymacro.CATScript"

./catstart -run "CNEXT -batch -macro "/tmp/Mymacro.CATScript""

./catstart -run "CNEXT -admin" 

if you want to run in administrator mode (using the default environment) for the purpose of locking settings. This prevents all users of that environment from changing the settings you locked.

You could also enter the command:

./catstart -run "CNEXT -env my_env -admin"

where "my_env" is the name of your environment. For more information, refer to Locking Settings.

Options for the CNEXT Program

CNEXT

also has the following options:

• -admin: starts a session in administrator mode for the purpose of locking settings
• -batch: starts a session in batch mode (an interactive session is not displayed)
• -c: starts a session and activates the workbench you specify
• -env: starts a session and executes an environment you specify
• -macro: used with "-object", this argument starts a session and runs the macro whose name you specify
• -object: followed by object to load (between " ") when starting a session; for example, the following command runs a session and loads a document:

./catstart -run CNEXT -object "/tmp/My.CATPart"

Or, followed by arguments between " "; for example, -object "arg1 arg2"

• -workbench workbench_name: starts a session and directly opens the workbench specified. The string "workbench_name" is the name of the workbench as it appears in the Start menu.
  For example, when using CATIA, the command:
  ./catstart -run "CNEXT -workbench Part Design"
starts a session and opens the Part Design workbench directly.
• -h: displays help.