-
Notifications
You must be signed in to change notification settings - Fork 16
/
smc_chk.8
115 lines (99 loc) · 2.07 KB
/
smc_chk.8
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.\" Copyright IBM Corp. 2021
.TH SMC_CHK 8 "January 2021" "smc-tools" "Linux Programmer's Manual"
.SH NAME
smc_chk \- SMC support diagnostics
.SH SYNOPSIS
.nf
.BI "smc_chk [OPTIONS] -C " IP
.BI "smc_chk [OPTIONS] -S"
.BI "smc_chk -i "INTERFACE
.SH DESCRIPTION
Use
.B -C/--connect
to obtain diagnostic information about the SMC support of a service that runs at a
given
.IR IP
address.
Otherwise, you can use
.B -S/--server
to start a server before connecting with
.IR -C .
Use
.B -i/--pnetid
to print the PNET ID of a specified
.IR INTERFACE .
.SH OPTIONS
.TP
.BI "\-C, \-\-connect " IP
Test SMC-D and SMC-R connectivity to
.IR IP .
Use option
.B -p/--port
to specify a
.IR PORT .
.I IP
can specify any service, including remote services.
By default,
.I IP
is assumed to be in IPv4 format.
Specify
.B -6/--IPv6
if
.I IP
is an address in IPv6 format.
.TP
.BR "\-d, \-\-debug "
Show debug messages.
.TP
.BR "\-h, \-\-help"
Display a brief
.B smc_chk
usage information.
.TP
.BI "\-i, \-\-pnetid " INTERFACE
Print the PNET ID of interface
.I INTERFACE
and exit. An appended asterisk * indicates that the PNET ID was defined via
.BR smc_pnet .
.TP
.BI "\-p, \-\-port " PORT
Use port
.I PORT
for any live tests. When starting a server via
.BR "\-S, \-\-server" ,
and if
.I PORT
is already in use, the next free port is used.
.TP
.BR "\-S, \-\-server"
Start a server for manual tests. Use option
.B -p/--port
to specify a port.
.TP
.BR "\-v, \-\-version"
Display version information.
.TP
.BR "\-6, \-\-ipv6"
.I IP
address provided is in IPv6 format.
.SH Examples
.SS "Check whether a z/OS instance running at 192.168.37.1 is enabled for \
SMC using the 3270 console service running on port 23"
smc_chk -C 192.168.37.1 -p 23
.SS "Print PNET ID of interface eth0"
smc_chk -i eth0
.SS "Start server on port 45901 (or the next successive free port) for smc_chk -C to connect to"
smc_chk -S -p 45901
.SH RETURN CODES
On success,
.B smc_chk
returns 0.
If an error occurs, a return code other than 0 is returned.
.P
.SH SEE ALSO
.BR af_smc (7),
.BR smc_pnet (8),
.BR smc_run (8),
.BR smcd (8),
.BR smcr (8),
.BR smcss (8)