mksess
Use the
mksess to create a
Replication Manager session specifying copy relationships among groups.
- For the source group, you cannot specify a group that is already being
managed by another session. A group cannot be assigned to more than one session
at any given time.
- If no groups exist, use the mkgroup command
to create a group.
- If no target pools exist, use the mktgtpool command to create a pool.
- The session is in a stopped state after initial creation. Use the startsess or the flashsesscommand
to start the copy process.
- Any errors that result from the creation of the session, for example,
not enough targets for sources or no path established, are reflected in the lscopyset command output.
Syntax

>>-repcli-- --mksess-- ---cptype-- copytype-- ------------------>
>---srcgrp--group_name-- --------------------------------------->
>---poolcrit--sequence_name:filter_type=filter_value-- --------->
>--+--------------------+-- --+----------------------+-- ------->
'--approve--+-man--+-' '--desc--"description"-'
'-auto-'
>--session_name-- ---------------------------------------------><
Parameters
- -cptype pprc|flash
- Specifies the copy type for the session. Specify either flash for FlashCopy or pprc for continuous,
synchronous, remote copy.
- -srcgrp group_name
- Specifies the source group for the session. Choose only one group per
session. Do not specify a group that is being managed
by another session.
- -poolcrit seq_name:filter_type=filter_value
- Specifies the criteria for target Replication Manager pools based on
sequence name and filter value. The sequence name is Remote Target for PPRC or Flashed Target for
FlashCopy. The filter type is the location. Use a colon to separate the sequence
name, filter type, and filter. Specify loc as the filter
value.
- -approve man | auto
- An optional parameter that validates the target. Specify man for manual; specify auto for automatic. The
default is automatic.
- -desc "description"
- An optional parameter that assigns a user-defined description of the
Replication Manager group. The maximum alphanumeric character length is 250.
- session_name
- Assigns a user-defined session name. The session name must be unique;
it cannot be the same as another existing Replication Manager session name.
The maximum alphanumeric character length is 250.
Description
You can use the mksesscommand to create a Replication
Manager session specifying copy relationships among groups.
Return values
Session session_name successfully created.
Possible failures
- Session session_name already exists.
- Group group_name does not exist.
- Pool pool_name does not exist.
- Group group_name is already managed in another
session.
- Incorrect use rname or password.
- Incorrect port.
- Target location is not valid or incorrect.
- Target explicit pool not valid or incorrect.
Examples
An invocation example:
repcli> mksess -cptype pprc -srcgrp mygroup -poolcrit "Remote Target:location=rtp" -approve auto mysession
The resulting output:
session mysession successfully created